ObjFW
|
A class for storing and manipulating arbitrary data in an array. More...
#import <ObjFW/OFMutableData.h>
Instance Methods | |
(id) | - init |
Initializes an already allocated OFMutableData with an item size of 1. More... | |
(id) | - initWithItemSize: |
Initializes an already allocated OFMutableData whose items all have the same size. More... | |
(id) | - initWithCapacity: |
Initializes an already allocated OFMutableData with enough memory to hold the the specified number of items which all have an item size of 1. More... | |
(id) | - initWithItemSize:capacity: |
Initializes an already allocated OFMutableData with enough memory to hold the the specified number of items which all have the same specified size. More... | |
(id) | - initWithItemsNoCopy:count:freeWhenDone: |
Initializes an already allocated OFData with the specified count items of size 1 by taking over ownership of the specified items pointer. More... | |
(id) | - initWithItemsNoCopy:itemSize:count:freeWhenDone: |
Initializes an already allocated OFData with the specified count items of the specified size by taking ownership of the specified items pointer. More... | |
(void) | - addItem: |
Adds an item to the OFMutableData. More... | |
(void) | - insertItem:atIndex: |
Adds an item to the OFMutableData at the specified index. More... | |
(void) | - addItems:count: |
Adds items from a C array to the OFMutableData. More... | |
(void) | - insertItems:atIndex:count: |
Adds items from a C array to the OFMutableData at the specified index. More... | |
(void) | - removeItemAtIndex: |
Removes the item at the specified index. More... | |
(void) | - removeItemsInRange: |
Removes the specified amount of items at the specified index. More... | |
(void) | - removeLastItem |
Removes the last item. | |
(void) | - removeAllItems |
Removes all items. | |
(void) | - makeImmutable |
Converts the mutable URL to an immutable URL. | |
(void *) | - items |
Returns all items of the OFMutableData as a C array. More... | |
(void *) | - itemAtIndex: |
Returns a specific item of the OFMutableData. More... | |
(nullable void *) | - firstItem |
Returns the first item of the OFMutableData. More... | |
(nullable void *) | - lastItem |
Returns the last item of the OFMutableData. More... | |
Instance Methods inherited from OFData | |
(id) | - initWithItems:count: |
Initialized an already allocated OFData with the specified count items of size 1. More... | |
(id) | - initWithItems:itemSize:count: |
Initialized an already allocated OFData with the specified count items of the specified size. More... | |
(id) | - initWithContentsOfFile: |
Initializes an already allocated OFData with an item size of 1, containing the data of the specified file. More... | |
(id) | - initWithContentsOfURL: |
Initializes an already allocated OFData with an item size of 1, containing the data of the specified URL. More... | |
(id) | - initWithStringRepresentation: |
Initializes an already allocated OFData with an item size of 1, containing the data of the string representation. More... | |
(id) | - initWithBase64EncodedString: |
Initializes an already allocated OFData with an item size of 1, containing the data of the Base64-encoded string. More... | |
(size_t) | - count |
Returns the number of items in the OFData. More... | |
(OFString *) | - stringRepresentation |
Returns the string representation of the data. More... | |
(OFString *) | - stringByBase64Encoding |
Returns a string containing the data in Base64 encoding. More... | |
(void) | - writeToFile: |
Writes the OFData into the specified file. More... | |
(OFString *) | - MD5Hash |
Returns the MD5 hash of the data array as an autoreleased OFString. More... | |
(OFString *) | - RIPEMD160Hash |
Returns the RIPEMD-160 hash of the data array as an autoreleased OFString. More... | |
(OFString *) | - SHA1Hash |
Returns the SHA-1 hash of the data array as an autoreleased OFString. More... | |
(OFString *) | - SHA224Hash |
Returns the SHA-224 hash of the data array as an autoreleased OFString. More... | |
(OFString *) | - SHA256Hash |
Returns the SHA-256 hash of the data array as an autoreleased OFString. More... | |
(OFString *) | - SHA384Hash |
Returns the SHA-384 hash of the data array as an autoreleased OFString. More... | |
(OFString *) | - SHA512Hash |
Returns the SHA-512 hash of the data array as an autoreleased OFString. More... | |
(id) | - messagePackValue |
Parses the MessagePack representation and returns it as an object. More... | |
(id) | - messagePackValueWithDepthLimit: |
Parses the MessagePack representation and returns it as an object. More... | |
Instance Methods inherited from OFObject | |
(OFString *) | - className |
Returns the name of the object's class. More... | |
(OFString *) | - description |
Returns a description for the object. More... | |
(nullable void *) | - allocMemoryWithSize: |
Allocates memory and stores it in the object's memory pool. More... | |
(nullable void *) | - allocMemoryWithSize:count: |
Allocates memory for the specified number of items and stores it in the object's memory pool. More... | |
(nullable void *) | - resizeMemory:size: |
Resizes memory in the object's memory pool to the specified size. More... | |
(nullable void *) | - resizeMemory:size:count: |
Resizes memory in the object's memory pool to the specific number of items of the specified size. More... | |
(void) | - freeMemory: |
Frees allocated memory and removes it from the object's memory pool. More... | |
(void) | - dealloc |
Deallocates the object. More... | |
(void) | - performSelector:afterDelay: |
Performs the specified selector after the specified delay. More... | |
(void) | - performSelector:withObject:afterDelay: |
Performs the specified selector with the specified object after the specified delay. More... | |
(void) | - performSelector:withObject:withObject:afterDelay: |
Performs the specified selector with the specified objects after the specified delay. More... | |
(void) | - performSelector:onThread:waitUntilDone: |
Performs the specified selector on the specified thread. More... | |
(void) | - performSelector:onThread:withObject:waitUntilDone: |
Performs the specified selector on the specified thread with the specified object. More... | |
(void) | - performSelector:onThread:withObject:withObject:waitUntilDone: |
Performs the specified selector on the specified thread with the specified objects. More... | |
(void) | - performSelectorOnMainThread:waitUntilDone: |
Performs the specified selector on the main thread. More... | |
(void) | - performSelectorOnMainThread:withObject:waitUntilDone: |
Performs the specified selector on the main thread with the specified object. More... | |
(void) | - performSelectorOnMainThread:withObject:withObject:waitUntilDone: |
Performs the specified selector on the main thread with the specified objects. More... | |
(void) | - performSelector:onThread:afterDelay: |
Performs the specified selector on the specified thread after the specified delay. More... | |
(void) | - performSelector:onThread:withObject:afterDelay: |
Performs the specified selector on the specified thread with the specified object after the specified delay. More... | |
(void) | - performSelector:onThread:withObject:withObject:afterDelay: |
Performs the specified selector on the specified thread with the specified objects after the specified delay. More... | |
(nullable id) | - forwardingTargetForSelector: |
This method is called when resolveClassMethod: or resolveInstanceMethod: returned false. It should return a target to which the message should be forwarded. More... | |
(void) | - doesNotRecognizeSelector: |
Handles messages which are not understood by the receiver. More... | |
(OFString *) | - stringBySerializing |
Creates a string by serializing the receiver. More... | |
Instance Methods inherited from <OFObject> | |
(bool) | - isKindOfClass: |
Returns a boolean whether the object of the specified kind. More... | |
(bool) | - isMemberOfClass: |
Returns a boolean whether the object is a member of the specified class. More... | |
(bool) | - respondsToSelector: |
Returns a boolean whether the object responds to the specified selector. More... | |
(nullable IMP) | - methodForSelector: |
Returns the implementation for the specified selector. More... | |
(nullable const char *) | - typeEncodingForSelector: |
Returns the type encoding for the specified selector. More... | |
(nullable id) | - performSelector: |
Performs the specified selector. More... | |
(nullable id) | - performSelector:withObject: |
Performs the specified selector with the specified object. More... | |
(nullable id) | - performSelector:withObject:withObject: |
Performs the specified selector with the specified objects. More... | |
(bool) | - isEqual: |
Checks two objects for equality. More... | |
(uint32_t) | - hash |
Calculates a hash for the object. More... | |
(id) | - retain |
Increases the retain count. More... | |
(unsigned int) | - retainCount |
Returns the retain count. More... | |
(void) | - release |
Decreases the retain count. More... | |
(id) | - autorelease |
Adds the object to the topmost OFAutoreleasePool of the thread's autorelease pool stack. More... | |
(id) | - self |
Returns the receiver. More... | |
(bool) | - isProxy |
Returns whether the object is a proxy object. More... | |
(bool) | - allowsWeakReference |
Returns whether the class allows weak references. More... | |
(bool) | - retainWeakReference |
Retain a weak reference to this object. More... | |
Instance Methods inherited from <OFCopying> | |
(id) | - copy |
Copies the object. More... | |
Instance Methods inherited from <OFMutableCopying> | |
(id) | - mutableCopy |
Creates a mutable copy of the object. More... | |
Instance Methods inherited from <OFSerialization> | |
(id) | - initWithSerialization: |
Initializes the object with the specified XML element serialization. More... | |
(OFXMLElement *) | - XMLElementBySerializing |
Serializes the object into an XML element. More... | |
Class Methods | |
(instancetype) | + data |
Creates a new OFMutableData with an item size of 1. More... | |
(instancetype) | + dataWithItemSize: |
Creates a new OFMutableData whose items all have the same specified size. More... | |
(instancetype) | + dataWithCapacity: |
Creates a new OFMutableData with enough memory to hold the specified number of items which all have an item size of 1. More... | |
(instancetype) | + dataWithItemSize:capacity: |
Creates a new OFMutableData with enough memory to hold the specified number of items which all have the same specified size. More... | |
(instancetype) | + dataWithItemsNoCopy:count:freeWhenDone: |
Creates a new OFData with the specified count items of size 1 by taking over ownership of the specified items pointer. More... | |
(instancetype) | + dataWithItemsNoCopy:itemSize:count:freeWhenDone: |
Creates a new OFData with the specified count items of the specified size by taking ownership of the specified items pointer. More... | |
Class Methods inherited from OFData | |
(instancetype) | + dataWithItems:count: |
Creates a new OFData with the specified count items of size 1. More... | |
(instancetype) | + dataWithItems:itemSize:count: |
Creates a new OFData with the specified count items of the specified size. More... | |
(instancetype) | + dataWithContentsOfFile: |
Creates a new OFData with an item size of 1, containing the data of the specified file. More... | |
(instancetype) | + dataWithContentsOfURL: |
Creates a new OFData with an item size of 1, containing the data of the specified URL. More... | |
(instancetype) | + dataWithStringRepresentation: |
Creates a new OFData with an item size of 1, containing the data of the string representation. More... | |
(instancetype) | + dataWithBase64EncodedString: |
Creates a new OFData with an item size of 1, containing the data of the Base64-encoded string. More... | |
Class Methods inherited from OFObject | |
(void) | + load |
A method which is called once when the class is loaded into the runtime. More... | |
(void) | + unload |
A method which is called when the class is unloaded from the runtime. More... | |
(void) | + initialize |
A method which is called the moment before the first call to the class is being made. More... | |
(id) | + alloc |
Allocates memory for an instance of the class and sets up the memory pool for the object. More... | |
(id) | + new |
Allocates memory for a new instance and calls init on it. More... | |
(Class) | + class |
Returns the class. More... | |
(OFString *) | + className |
Returns the name of the class as a string. More... | |
(bool) | + isSubclassOfClass: |
Returns a boolean whether the class is a subclass of the specified class. More... | |
(nullable Class) | + superclass |
Returns the superclass of the class. More... | |
(bool) | + instancesRespondToSelector: |
Checks whether instances of the class respond to a given selector. More... | |
(bool) | + conformsToProtocol: |
Checks whether the class conforms to a given protocol. More... | |
(nullable IMP) | + instanceMethodForSelector: |
Returns the implementation of the instance method for the specified selector. More... | |
(nullable const char *) | + typeEncodingForInstanceSelector: |
Returns the type encoding of the instance method for the specified selector. More... | |
(OFString *) | + description |
Returns a description for the class, which is usually the class name. More... | |
(nullable IMP) | + replaceClassMethod:withMethodFromClass: |
Replaces a class method with a class method from another class. More... | |
(nullable IMP) | + replaceInstanceMethod:withMethodFromClass: |
Replaces an instance method with an instance method from another class. More... | |
(nullable IMP) | + replaceClassMethod:withImplementation:typeEncoding: |
Replaces or adds a class method. More... | |
(nullable IMP) | + replaceInstanceMethod:withImplementation:typeEncoding: |
Replaces or adds an instance method. More... | |
(void) | + inheritMethodsFromClass: |
Adds all methods from the specified class to the class that is the receiver. More... | |
(BOOL) | + resolveClassMethod: |
Try to resolve the specified class method. More... | |
(BOOL) | + resolveInstanceMethod: |
Try to resolve the specified instance method. More... | |
(id) | + copy |
Returns the class. More... | |
Additional Inherited Members | |
Properties inherited from OFData | |
size_t | itemSize |
A class for storing and manipulating arbitrary data in an array.
- (void) addItem: | (const void *) | item |
Adds an item to the OFMutableData.
item | A pointer to an arbitrary item |
- (void) addItems: | (const void *) | items | |
count: | (size_t) | count | |
Adds items from a C array to the OFMutableData.
items | A C array containing the items to add |
count | The number of items to add |
+ (instancetype) data |
Creates a new OFMutableData with an item size of 1.
+ (instancetype) dataWithCapacity: | (size_t) | capacity |
Creates a new OFMutableData with enough memory to hold the specified number of items which all have an item size of 1.
capacity | The initial capacity for the OFMutableData |
+ (instancetype) dataWithItemSize: | (size_t) | itemSize |
Creates a new OFMutableData whose items all have the same specified size.
itemSize | The size of a single element in the OFMutableData |
+ (instancetype) dataWithItemSize: | (size_t) | itemSize | |
capacity: | (size_t) | capacity | |
Creates a new OFMutableData with enough memory to hold the specified number of items which all have the same specified size.
itemSize | The size of a single element in the OFMutableData |
capacity | The initial capacity for the OFMutableData |
+ (instancetype) dataWithItemsNoCopy: | (const void *) | items | |
count: | (size_t) | count | |
freeWhenDone: | (bool) | freeWhenDone | |
Creates a new OFData with the specified count
items of size 1 by taking over ownership of the specified items pointer.
items | The items to store in the OFData |
count | The number of items |
freeWhenDone | Whether to free the pointer when it is no longer needed by the OFData |
Reimplemented from OFData.
+ (instancetype) dataWithItemsNoCopy: | (const void *) | items | |
itemSize: | (size_t) | itemSize | |
count: | (size_t) | count | |
freeWhenDone: | (bool) | freeWhenDone | |
Creates a new OFData with the specified count
items of the specified size by taking ownership of the specified items pointer.
items | The items to store in the OFData |
itemSize | The item size of a single item in bytes |
count | The number of items |
freeWhenDone | Whether to free the pointer when it is no longer needed by the OFData |
Reimplemented from OFData.
- (nullable void *) firstItem |
Returns the first item of the OFMutableData.
Modifying the returned item directly is allowed and will change the contents of the data array.
Reimplemented from OFData.
- (id) init |
Initializes an already allocated OFMutableData with an item size of 1.
Reimplemented from OFObject.
- (id) initWithCapacity: | (size_t) | capacity |
Initializes an already allocated OFMutableData with enough memory to hold the the specified number of items which all have an item size of 1.
capacity | The initial capacity for the OFMutableData |
- (id) initWithItemSize: | (size_t) | itemSize |
Initializes an already allocated OFMutableData whose items all have the same size.
itemSize | The size of a single element in the OFMutableData |
- (id) initWithItemSize: | (size_t) | itemSize | |
capacity: | (size_t) | capacity | |
Initializes an already allocated OFMutableData with enough memory to hold the the specified number of items which all have the same specified size.
itemSize | The size of a single element in the OFMutableData |
capacity | The initial capacity for the OFMutableData |
- (id) initWithItemsNoCopy: | (const void *) | items | |
count: | (size_t) | count | |
freeWhenDone: | (bool) | freeWhenDone | |
Initializes an already allocated OFData with the specified count
items of size 1 by taking over ownership of the specified items pointer.
items | The items to store in the OFData |
count | The number of items |
freeWhenDone | Whether to free the pointer when it is no longer needed by the OFData |
Reimplemented from OFData.
- (id) initWithItemsNoCopy: | (const void *) | items | |
itemSize: | (size_t) | itemSize | |
count: | (size_t) | count | |
freeWhenDone: | (bool) | freeWhenDone | |
Initializes an already allocated OFData with the specified count
items of the specified size by taking ownership of the specified items pointer.
items | The items to store in the OFData |
itemSize | The item size of a single item in bytes |
count | The number of items |
freeWhenDone | Whether to free the pointer when it is no longer needed by the OFData |
Reimplemented from OFData.
- (void) insertItem: | (const void *) | item | |
atIndex: | (size_t) | index | |
Adds an item to the OFMutableData at the specified index.
item | A pointer to an arbitrary item |
index | The index where the item should be added |
- (void) insertItems: | (const void *) | items | |
atIndex: | (size_t) | index | |
count: | (size_t) | count | |
Adds items from a C array to the OFMutableData at the specified index.
items | A C array containing the items to add |
index | The index where the items should be added |
count | The number of items to add |
- (void *) itemAtIndex: | (size_t) | index |
Returns a specific item of the OFMutableData.
Modifying the returned item directly is allowed and will change the contents of the data array.
index | The number of the item to return |
Reimplemented from OFData.
- (void *) items |
Returns all items of the OFMutableData as a C array.
Modifying the returned array directly is allowed and will change the contents of the data array.
Reimplemented from OFData.
- (nullable void *) lastItem |
Returns the last item of the OFMutableData.
Modifying the returned item directly is allowed and will change the contents of the data array.
Reimplemented from OFData.
- (void) removeItemAtIndex: | (size_t) | index |
Removes the item at the specified index.
index | The index of the item to remove |
- (void) removeItemsInRange: | (of_range_t) | range |
Removes the specified amount of items at the specified index.
range | The range of items to remove |