src/OFDataArray.h

/*
 * Copyright (c) 2008, 2009, 2010, 2011, 2012
 *   Jonathan Schleifer <js@webkeks.org>
 *
 * All rights reserved.
 *
 * This file is part of ObjFW. It may be distributed under the terms of the
 * Q Public License 1.0, which can be found in the file LICENSE.QPL included in
 * the packaging of this file.
 *
 * Alternatively, it may be distributed under the terms of the GNU General
 * Public License, either version 2 or 3, which can be found in the file
 * LICENSE.GPLv2 or LICENSE.GPLv3 respectively included in the packaging of this
 * file.
 */

#import "OFObject.h"
#import "OFSerialization.h"

@class OFString;
@class OFURL;

@interface OFDataArray: OFObject <OFCopying, OFComparing, OFSerialization>
{
        char   *data;
        size_t count;
        size_t itemSize;
}

#ifdef OF_HAVE_PROPERTIES
@property (readonly, getter=cArray) void *data;
@property (readonly) size_t count;
@property (readonly) size_t itemSize;
#endif

+ dataArray;

+ dataArrayWithItemSize: (size_t)itemSize;

+ dataArrayWithContentsOfFile: (OFString*)path;

+ dataArrayWithContentsOfURL: (OFURL*)URL;

+ dataArrayWithBase64EncodedString: (OFString*)string;

- init;

- initWithItemSize: (size_t)itemSize;

- initWithContentsOfFile: (OFString*)path;

- initWithContentsOfURL: (OFURL*)URL;

- initWithBase64EncodedString: (OFString*)string;

- (size_t)count;

- (size_t)itemSize;

- (void*)cArray;

- (void*)itemAtIndex: (size_t)index;

- (void*)firstItem;

- (void*)lastItem;

- (void)addItem: (const void*)item;

- (void)addItem: (const void*)item
        atIndex: (size_t)index;

- (void)addNItems: (size_t)nItems
       fromCArray: (const void*)cArray;

- (void)addNItems: (size_t)nItems
       fromCArray: (const void*)cArray
          atIndex: (size_t)index;

- (void)removeItemAtIndex: (size_t)index;

- (void)removeNItems: (size_t)nItems;

- (void)removeNItems: (size_t)nItems
             atIndex: (size_t)index;

- (void)removeLastItem;

- (void)removeAllItems;

- (OFString*)stringByBase64Encoding;

- (void)writeToFile: (OFString*)path;
@end

@interface OFBigDataArray: OFDataArray
{
        size_t size;
}
@end

#import "OFDataArray+Hashing.h"