Key-Value Coding Programming Guide 官方文档第二部分第4节
2018.9.20 第一次修正
Key-Value Coding Fundamatals--Representing Non-Object Values
表示非对象值
通过NSObject使用对象和非对象属性提供的键值编码协议方法的默认实现。 默认实现自动在对象参数或返回值以及非对象属性之间进行转换。 这允许即使存储的属性是标量或结构体，基于key的getter和setter的命名也保持一致。
注意
因为Swift中的所有属性都是对象，所以本节仅适用于Objective-C属性。
当你调用协议的其中一个getter时，valueForKey：，默认实现根据Accessor Search Patterns中描述的规则 确定为指定键提供值的特定访问器方法或实例变量。 如果返回值不是对象，则getter使用此值初始化NSNumber对象（对于标量）或NSValue对象（对于结构体）并返回该值。
同样，默认情况下，像setValue：forKey:这样的setter在给定特定键的情况下确定属性的访问器或实例变量所需的数据类型。 如果数据类型不是对象，则setter首先向传入值对象发送适当的<type> Value消息以提取基础数据，并存储该数据。
注意
当您使用非对象属性的nil值调用其中一个KVC协议setter时，setter没有明显的一般操作过程。 因此，它向接收setter调用的对象发送setNilValueForKey：消息。 此方法的默认实现引发NSInvalidArgumentException异常，但子类可能会覆盖此行为，如Handling Non-Object Values中所述，例如设置标记值或提供有意义的默认值。
包装和解包标量类型
Table 5-1 列出默认KVC实现使用NSNumber实例包装的标量类型。 对于每种数据类型，该表显示用于初始化NSNumber基础属性值以提供getter返回值的创建方法。 然后显示用于在设置操作期间从setter输入参数中提取值的访问器方法。
Table 5-1 标量类型包含在NSNumber对象中
| Data type | Creation method | Accessor method |
|---|---|---|
BOOL |
numberWithBool: |
boolValue (in iOS) charValue (in macOS)* |
char |
numberWithChar: |
charValue |
double |
numberWithDouble: |
doubleValue |
float |
numberWithFloat: |
floatValue |
int |
numberWithInt: |
intValue |
long |
numberWithLong: |
longValue |
long long |
numberWithLongLong: |
longLongValue |
short |
numberWithShort: |
shortValue |
unsigned char |
numberWithUnsignedChar: |
unsignedChar |
unsigned int |
numberWithUnsignedInt: |
unsignedInt |
unsigned long |
numberWithUnsignedLong: |
unsignedLong |
unsigned long long |
numberWithUnsignedLongLong: |
unsignedLongLong |
unsigned short |
numberWithUnsignedShort: |
unsignedShort |
注意
*在macOS中，由于历史原因，BOOL的类型定义为signed char，而KVC不区分这些。 因此，当key为BOOL时，不应将字符串值（例如@“true”或@“YES”）传递给setValue：forKey：。 KVC将尝试调用charValue（因为BOOL本身就是一个char），但是NSString没有实现这个方法，这会导致运行时错误。 相反，当key为BOOL时，只传递一个NSNumber对象，如@(1)或@(YES)，作为setValue：forKey:的值参数。 此限制不适用于iOS，其中BOOL的类型定义为本机布尔类型bool，KVC调用boolValue，它适用于NSNumber对象或格式正确的NSString对象。
包装和解包结构体
Table 5-2 下面列出了可以包装成NSPoint，NSRange，NSRect和NSSize的常用结构体的转化方法和取值方法
Table 5-2 包装成NSValue的常用结构类型
| Data type | Creation method | Accessor method |
|---|---|---|
| NSPoint | valueWithPoint: | pointValue |
| NSRange | valueWithRange: | rangeValue |
| NSRect | valueWithRect: (macOS only). | rectValue |
| NSSize | valueWithSize: | sizeValue |
不仅NSPoint，NSRange，NSRect和NSSize的可以自动包装和解包。 结构体类型（即Objective-C类型中字符串以{开头编码的类型）也可以包成NSValue对象中。 例如，参考5-1表格中声明的结构体和类接口。
Listing 5-1 使用自定义结构体的类
typedef struct {
float x, y, z;
} ThreeFloats;
@interface MyClass
@property (nonatomic) ThreeFloats threeFloats;
@end
使用名为myClass的类的实例，可以使用KVC获取threeFloats值
NSValue* result = [myClass valueForKey:@"threeFloats"];
valueForKey：的默认实现调用threeFloats 的getter方法，然后返回包含在NSValue对象中的结果。
同样，您可以使用KVC设置threeFloats值：
ThreeFloats floats = {1., 2., 3.};
NSValue* value = [NSValue valueWithBytes:&floats objCType:@encode(ThreeFloats)];
[myClass setValue:value forKey:@"threeFloats"];
默认实现使用getValue:方法解包值，然后使用setThreeFloats:生成的结构体进行调用。
由于笔者水平有限，文中如果有错误的地方，或者有更好的方法，还望大神指出。
附上本文的所有 demo 下载链接，【GitHub】。
如果你看完后觉得对你有所帮助，还望在 GitHub 上点个 star。赠人玫瑰，手有余香。
