NSKeyValueCoding

A mechanism by which you can access the properties of an object indirectly by name or key. それによってあなたがあるオブジェクトのプロパティに名前またはキーによって間接的にアクセスできるある仕組み。

Overview 概要

The basic methods for accessing an object’s values are setValue:forKey:, which sets the value for the property identified by the specified key, and valueForKey:, which returns the value for the property identified by the specified key. Thus, all of an object’s properties can be accessed in a consistent manner.

The default implementation relies on the accessor methods normally implemented by objects (or to access instance variables directly if need be).

Topics 話題

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.

- mutableArrayValueForKey:

Returns a mutable array proxy that provides read-write access to an ordered to-many relationship specified by 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.

Setting Values 値を設定する

- setValue:forKeyPath:

Sets the value for the property identified by a given key path to a given value.

- setValuesForKeysWithDictionary:

Sets properties of the receiver with values from a given dictionary, using its keys to identify the properties.

- setNilValueForKey:

Invoked by setValue:forKey: when it’s given a nil value for a scalar value (such as an int or float).

- setValue:forKey:

Sets the property of the receiver specified by a given key to a given value.

- setValue:forUndefinedKey:

Invoked by setValue:forKey: when it finds no property for a given key.

Changing Default Behavior

accessInstanceVariablesDirectly

Returns a Boolean value that indicates whether the key-value coding methods should access the corresponding instance variable directly on finding no accessor method for a property.

Validation 検証

- validateValue:forKey:error:

Returns a Boolean that indicates whether the value specified by a given pointer is valid for the property identified by a given key.

- validateValue:forKeyPath:error:

Returns a Boolean that indicates whether the value specified by a given pointer is valid for a given key path relative to the receiver.

Deprecated Methods 非推奨メソッド

+ useStoredAccessor

Returns YES if the stored value methods storedValueForKey: and takeStoredValue:forKey: should use private accessor methods in preference to public accessors.

Deprecated 非推奨

- handleQueryWithUnboundKey:

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

Deprecated 非推奨

- handleTakeValue:forUnboundKey:

Invoked by takeValue:forKey: when it finds no property binding for key.

Deprecated 非推奨

- storedValueForKey:

Returns the property identified by a given key.

Deprecated 非推奨

- takeStoredValue:forKey:

Sets the value of the property identified by a given key.