寫 Objective-C 時經常需要把 C 的原生資料包裝成物件,才能放進 NSDictionary 或 NSArray 中存取;尤其在處理 API 適用的情況下,這種包裝幾乎無法避免。Cocoa 提供了幾個現成的類,最常見的是 NSNumber、NSValue 與 NSData。
主要用來包裝 char、float、int 等 ANSI C 內建型別,提供成對的封裝/解封方法:
+ (NSNumber *)numberWithChar:(char)value; + (NSNumber *)numberWithUnsignedChar:(unsigned char)value; + (NSNumber *)numberWithShort:(short)value; + (NSNumber *)numberWithUnsignedShort:(unsigned short)value; + (NSNumber *)numberWithInt:(int)value; + (NSNumber *)numberWithUnsignedInt:(unsigned int)value; + (NSNumber *)numberWithLong:(long)value; + (NSNumber *)numberWithUnsignedLong:(unsigned long)value; - (char)charValue; - (unsigned char)unsignedCharValue; - (short)shortValue; - (unsigned short)unsignedShortValue; - (int)intValue; - (unsigned int)unsignedIntValue; - (long)longValue; - (unsigned long)unsignedLongValue;
使用方式:
NSNumber *number = [NSNumber numberWithInt:1234]; int i = [number intValue];
用來包裝自訂的 struct,也可以是系統提供的 CGRect/CGPoint/CGSize 等結構。核心方法只有一對:
+ (NSValue *)valueWithBytes:(const void *)value objCType:(const char *)type; - (void)getValue:(void *)value;
以自訂結構為例:
typedef struct testTag {
int a;
char *b;
} TEST_DATA_ST; // 定義資料結構
TEST_DATA_ST stValue = {0};
stValue.a = 58; // 建立並賦初值
NSValue *value = [NSValue valueWithBytes:&stValue objCType:@encode(TEST_DATA_ST)]; // 封裝
TEST_DATA_ST testValue = {0};
[value getValue:&testValue]; // 解封
關鍵細節:type 參數要用 @encode() 包住型別,這樣 NSValue 才知道資料的記憶體佈局。
針對幾個常見結構,框架已直接提供便利方法:
+ (NSValue *)valueWithCGPoint:(CGPoint)point; + (NSValue *)valueWithCGSize:(CGSize)size; + (NSValue *)valueWithCGRect:(CGRect)rect; - (CGPoint)CGPointValue; - (CGSize)CGSizeValue; - (CGRect)CGRectValue;
順帶一提,NSNumber 其實就是 NSValue 的特例,因此在類別繼承關係上,NSNumber 是 NSValue 的子類。
NSData 提供的是最素樸的封裝——一塊原始位元組,方便資料在系統各處流動,最常見的用途是包裝 NSString/NSImage,以及讀寫檔案與網路資源。
+ (id)dataWithBytes:(const void *)bytes length:(NSUInteger)length; - (NSUInteger)length; - (const void *)bytes;
從這三個方法就看得出來,NSData 完全不關心內容是什麼,只需要起始位址與長度。使用範例:
char *str = "Hello, World!"; NSData *strData = [NSData dataWithBytes:str length:strlen(str) + 1]; // 封裝 NSString *result = [NSString stringWithUTF8String:[strData bytes]]; // 用 bytes 取回內容
簡單的原則:純量數值用 NSNumber,結構或自訂型別用 NSValue,連續位元組或檔案內容用 NSData。三者都是為了同一件事——讓 C 的世界能走進 Objective-C 的容器。