+ newReturns a new empty dictionary.
copy
- copy
Returns a new copy of the dictionary.
deepCopy
- deepCopy
Returns a new copy of the dictionary. The members in the new dictionary are deep copies of the members in the original dictionary.
emptyYourself
- emptyYourself
Removes all the keys and values of the dictionary (without freeing them). Returns the receiver.
freeContents
- freeContents
Removes and frees all the members of the receiver, but doesn't free the receiver itself. Returns the receiver.
free
- free
Frees the dictionary, but not its contents. Returns nil. Do :
if you want to free the dictionary and its contents.
aDic = [[aDic freeContents] free];
size
- (unsigned) size
Returns the number of key-value associations in the dictionary.
isEmpty
- (BOOL) isEmpty
Whether the number of associations in the dictionary is equal to zero.
idEmpty
- idEmpty
This method is like isEmpty but it returns the Object idTrue if the collection is empty, or idFalse otherwise.
includesKey:
- (BOOL) includesKey : aKey
Returns YES if there is an association with key matching aKey.
hash
- (unsigned) hash
Returns a hash value based on the receiver's address and the results of sending the hash message to the contents.
isEqual:
- (BOOL) isEqual : aDic
Returns YES if aDic is a dictionary, and if its keys and values respond affirmatively to the message isEqual: when compared to the corresponding objects of the receiver's contents.
atKey:
- atKey : aKey
Returns the value of the association matching aKey. Returns nil if the association is not found.
atKey:ifAbsent:
- atKey : aKey ifAbsent : exceptionBlock
Returns the value of the association matching aKey. Evaluates exceptionBlock and returns its return value, if the association is not found.
atKeySTR:
- atKeySTR :(STR) strKey
Returns the value of the association matching strKey. Returns nil if the association is not found.
atKey:put:
- atKey : aKey put : anObject
Associates aKey to anObject. Adds the objects to the dictionary. If aKey was already in the dictionary, makes anObject the value for this key and returns the old value. Otherwise returns nil.
atKeySTR:put:
- atKeySTR :(STR) strKey put : anObject
Associates strKey to anObject. Adds the objects to the dictionary. If strKey was already in the dictionary, makes anObject the value for this key and returns the old value. Otherwise returns nil.
eachKey
- eachKey
Returns a sequence of the key objects in the dictionary.
See also: eachValue
keys = [aDic eachKey];
while ((aKey = [aSeq next])) {
/* do something */
}
keys = [keys free];
eachValue
- eachValue
Returns a sequence of the value objects in the dictionary.
See also: eachKey
keys = [aDic eachKey];
values = [aDic eachValue];
while ((aKey = [aSeq next])) {
aValue = [values next];
/* do something */
}
keys = [keys free];
values = [values free];