NSData 與它的可變子類 NSMutableData 提供了一種資料物件——本質上是位元組緩衝區(byte buffer)的物件導向包裝。有了它,原本只是一塊記憶體的純資料,也能具備 Foundation 物件的一切行為:可以被複製、被檔案化、被放到 NSArray 裡、能在分散式物件環境中於不同應用之間傳遞。
NSObjectNSCopying、NSMutableCopying、NSSecureCodingNSData.hNSData 建立的是靜態資料物件,內容一旦確立便不可更改;NSMutableData 建立的則是可動態增刪的資料物件。兩者常用於資料儲存,也常用於網路傳輸——把抓回來的位元流包裝成物件,比直接操作指標安全得多。
關於容量,理論上限約為 8 EB(ExaBytes),實務上完全不必擔心撞到天花板。
NSData 與 Core Foundation 的 CFDataRef 採取「toll-free bridged」設計,兩者可以直接互轉而不需複製資料。這讓你在混用 C API 與 Objective-C 時省下大量拷貝成本。
從原始位元組:
+data(空資料)、+dataWithData:+dataWithBytes:length:、-initWithBytes:length:+dataWithBytesNoCopy:length:、+dataWithBytesNoCopy:length:freeWhenDone:、-initWithBytesNoCopy:length:、-initWithBytesNoCopy:length:freeWhenDone:、-initWithBytesNoCopy:length:deallocator:從檔案或 URL:
+dataWithContentsOfFile:、+dataWithContentsOfFile:options:error:+dataWithContentsOfURL:、+dataWithContentsOfURL:options:error:-initWithContentsOfFile:... 與 -initWithContentsOfURL:...從 Base64:
-initWithBase64EncodedData:options:、-initWithBase64EncodedString:options:已被淘汰的部分包括 -initWithBase64Encoding:(iOS 7.0)、+dataWithContentsOfMappedFile: 與 -initWithContentsOfMappedFile:(iOS 5.0)。記憶體映射檔案的做法如今建議改用 NSDataReadingMappedIfSafe 選項搭配現代的初始化方法。
-bytes 回傳位元組指標,-getBytes:length: 與 -getBytes:range: 把資料複製到你的緩衝區,-subdataWithRange: 裁出一段子資料,-enumerateByteRangesUsingBlock: 以 block 逐段遍歷(適合大檔案),-rangeOfData:options:range: 則用來搜尋子資料。舊的 -getBytes: 已在 iOS 4.0 淘汰。
-base64EncodedDataWithOptions: 與 -base64EncodedStringWithOptions: 是 iOS 7 之後的標準做法,用 NSDataBase64EncodingOptions 控制換行與填充行為。舊的 -base64Encoding 已在 iOS 7.0 淘汰,新專案請勿再用。
-isEqualToData: 比較內容是否相同,-length 取得位元組數。要寫入檔案或 URL,則有 -writeToFile:atomically:、-writeToFile:options:error:、-writeToURL:atomically:、-writeToURL:options:error: 四種組合。原子寫入(atomically)能避免寫到一半被中斷而產生半截檔案,除非有明確理由,否則建議保持開啟。
資料來源:Apple Inc. NSData Class Reference(更新日期 2014-02-11)