Instance Method

mutableArrayValueForKey:

Returns a mutable array proxy that provides read-write access to an ordered to-many relationship specified by a given key.

Declaration

- (NSMutableArray *)mutableArrayValueForKey:(NSString *)key;

Parameters

key

The name of an ordered to-many relationship.

Return Value

A mutable array proxy that provides read-write access to the ordered to-many relationship specified by key.

Discussion

Objects added to the mutable array become related to the receiver, and objects removed from the mutable array become unrelated. The default implementation recognizes the same simple accessor methods and array accessor methods as valueForKey:, and follows the same direct instance variable access policies, but always returns a mutable collection proxy object instead of the immutable collection that valueForKey: would return.

The search pattern that mutableArrayValueForKey: uses is described in Accessor Search Patterns in Key-Value Coding Programming Guide.

See Also

Getting Values

- valueForKey:

Returns the value for the property identified by a given key.

- valueForKeyPath:

Returns the value for the derived property identified by a given key path.

- dictionaryWithValuesForKeys:

Returns a dictionary containing the property values identified by each of the keys in a given array.

- valueForUndefinedKey:

Invoked by valueForKey: when it finds no property corresponding to a given key.

- mutableArrayValueForKeyPath:

Returns a mutable array that provides read-write access to the ordered to-many relationship specified by a given key path.

- mutableSetValueForKey:

Returns a mutable set proxy that provides read-write access to the unordered to-many relationship specified by a given key.

- mutableSetValueForKeyPath:

Returns a mutable set that provides read-write access to the unordered to-many relationship specified by a given key path.

- mutableOrderedSetValueForKey:

Returns a mutable ordered set that provides read-write access to the uniquing ordered to-many relationship specified by a given key.

- mutableOrderedSetValueForKeyPath:

Returns a mutable ordered set that provides read-write access to the uniquing ordered to-many relationship specified by a given key path.

Beta Software

This documentation contains preliminary information about an API or technology in development. This information is subject to change, and software implemented according to this documentation should be tested with final operating system software.

Learn more about using Apple's beta software