@interface NSData: NSObject<NSCopying, NSMutableCopying, NSSecureCoding>
//獲取data長度的屬性
@property (readonly) NSUInteger length;
//返回data對象的首指針
@property (readonly) const void *bytes;
@interface NSData (NSExtendedData)
//返回一個ASCII編碼格式的字符串，采用的格式是data屬性列表的格式
@property (readonly, copy) NSString *description;
//取出data中指定長度的字節存入buffer這個提前聲明的數組中
- (void)getBytes:(void *)buffer length:(NSUInteger)length;
//取出data中指定位置range的字節存入buffer這個提前聲明的數組中
- (void)getBytes:(void *)buffer range:(NSRange)range;
//判斷兩個data是否相等
- (BOOL)isEqualToData:(NSData *)other;
//截取data指定位置的子data
- (NSData *)subdataWithRange:(NSRange)range;
//將data寫入指定的文件
- (BOOL)writeToFile:(NSString *)path atomically:(BOOL)useAuxiliaryFile;
//將data寫入指定的url
- (BOOL)writeToURL:(NSURL *)url atomically:(BOOL)atomically;
//將data寫入指定文件，并且有寫入過程的設置條件，帶錯誤信息
- (BOOL)writeToFile:(NSString *)path options:(NSDataWritingOptions)writeOptionsMark error:(NSError **)errorPtr;
//將data寫入指定的url,并且有寫入過程的設置條件，帶錯誤信息
- (BOOL)writeToURL:(NSURL *)url options:(NSDataWritingOptions)writeOptionsMark error:(NSError **)errorPtr;
//搜索在data1內部存在data2的位置，并且有搜索配置條件，并且可加入的搜索的范圍
- (NSRange)rangeOfData:(NSData *)dataToFind options:(NSDataSearchOptions)mark range:(NSRange)searchRange;
//列舉遍歷字典的方法
- (void)enumerateByteRangesUsingBlock:(void (^)(const void *bytes, NSRange byteRange, BOOL *stop))block;
@end
@interface NSData (NSDataCreation)
//data的快速創建辦法
+ (instancetype)data;
//賦值以bytes開頭，長度為length的數據，進行初始化使其成為數據對象的內容
+ (instancetype)dataWithBytes:(const void *)bytes length:(NSUInteger)length;
//這個方法生成的data中保存的是指向數據的指針，并沒有對數據進行復制操作
+ (instancetype)dataWithBytesNoCopy:(void *)bytes length:(NSUInteger)length;
//這個方法生成的data中保存的是指向數據的指針，并沒有對數據進行復制操作。當flag為yes的時候，生成的data對象是bytes的所有者，當data對象被釋放的時候也會同時釋放bytes，所以bytes必須是通過malloc在堆上分配的內存。當flag為no的時候，bytes不會被自動釋放，釋放bytes時要注意時機，不要再data對象還被使用的時候釋放bytes。
+ (instancetype)dataWithBytesNoCopy:(void*)bytes length:(NSUInteger)length freeWhenDone:(BOOL)b;
//加載file文件，并且有可選擇讀取文件的選項配置條件，帶有錯誤信息
+ (instancetype)dataWithContentsOfFile:(NSString*)path options:(NSDataReadingOptions)readOptionsMask error:(NSError**)errorPtr;
//加載url，并且有可選擇讀取文件的選項配置條件，帶有錯誤信息
+ (instancetype)dataWithContentsOfURL:(NSURL*)url options:(NSDataReadingOptions)readOptionsMask error:(NSError**)errorPtr;
//從參數path指定的文件讀入二進制數據，用該數據初始化NSData對象
+ (instancetype)dataWithContentsOfFile:(NSString*)path;
//從參數path指定的url讀入，用該數據初始化NSData對象
+ (instancetype)dataWithContentsOfURL:(NSURL*)url;
//賦值以bytes開頭，長度為length的數據，進行初始化使其成為數據對象的內容
- (instancetype)initWithBytes:(const void*)bytes length:(NSUInteger)length;
//這個方法生成的data中保存的是指向數據的指針，并沒有對數據進行復制操作。
- (instancetype)initWithBytesNoCopy:(void*)bytes length:(NSUInteger)length;
//這個方法生成的data中保存的是指向數據的指針，并沒有對數據進行復制操作。當flag為yes的時候，生成的data對象是bytes的所有者，當data對象被釋放的時候也會同時釋放bytes，所以bytes必須是通過malloc在堆上分配的內存。當flag為no的時候，bytes不會被自動釋放，釋放bytes時要注意時機，不要再data對象還被使用的時候釋放bytes。
- (instancetype)initWithBytesNoCopy:(void*)bytes length:(NSUInteger)length freeWhenDone:(BOOL)b;
//從參數path指定的文件讀入二進制數據，用該數據初始化NSData對象。如果讀取文件失敗，則釋放調用者并返回nil，同時把錯誤信息寫入指針errorPtr。mask是一個選項信息，用于指定是否使用虛擬內存等。
- (instancetype)initWithContentsOfFile:(NSString*)path options:(NSDataReadingOptions)readOptionsMask error:(NSError**)errorPtr;
//從參數url指定的路徑中讀入，用該數據初始化NSData對象。如果讀取文件失敗，則釋放調用者并返回nil，同時把錯誤信息寫入指針errorPtr。mask是一個選項信息，用于指定是否使用虛擬內存等。
- (instancetype)initWithContentsOfURL:(NSURL*)url options:(NSDataReadingOptions)readOptionsMask error:(NSError**)errorPtr;
//加載flie文件路徑
- (instancetype)initWithContentsOfFile:(NSString*)path;
//加載url
- (instancetype)initWithContentsOfURL:(NSURL*)url;
//用指定的NSData對象aData來創建一個新的NSData對象，參數可以是NSMutableData對象。
- (instancetype)initWithData:(NSData*)data;
//用指定的NSData對象aData來創建一個新的NSData對象，參數可以是NSMutableData對象。
+ (instancetype)dataWithData:(NSData*)data;
@end
/*** base64方案編碼分類? iOS7之后蘋果給出以下四個API供實現base64方案 頭兩個是處理字符串的，后兩個是處理UTF-8編碼數據的，這兩個承兌的方法功能是一樣的，但是有時候用其中一個比另一個效率要高。如果你像要bae64編碼字符串然后寫進文件，你應該使用UTF-8編碼數據的這對方法。如果你打算base64編碼字符串之后用作json，你應該使用另外一對方法編碼解碼一一對應***/
@interfaceNSData (NSDataBase64Encoding)
//解碼。將已經base64編碼之后的字符串數據再轉化為NSData數據，
- (instancetype)initWithBase64EncodedString:(NSString*)base64String options:(NSDataBase64DecodingOptions)optionsNS_AVAILABLE(10_9,7_0);
//編碼。將一個data數據利用base64方案轉化成base64之后的NSString字符串
- (NSString*)base64EncodedStringWithOptions:(NSDataBase64EncodingOptions)optionsNS_AVAILABLE(10_9,7_0);
//解碼。將已經base64編碼之后的NSData數據再轉化為NSData數據
- (instancetype)initWithBase64EncodedData:(NSData*)base64Data options:(NSDataBase64DecodingOptions)optionsNS_AVAILABLE(10_9,7_0);
//編碼.將一個data數據利用base64方案轉化成base64之后的NSData數據
- (NSData*)base64EncodedDataWithOptions:(NSDataBase64EncodingOptions)optionsNS_AVAILABLE(10_9,7_0);
/****************Mutable Data可變data****************/
@interfaceNSMutableData :NSData
//可變data的可變字節
@property (readonly) void* mutableBytes NS_RETURNS_INNER_POINTER;
//可變data的長度
@property NSUInteger length;
@end
@interface NSMutableData (NSExtendedMutableData)
//給可變data追加字節
- (void)appendBytes:(const void*)bytes length:(NSUInteger)length;
//給data追加其他的data
- (void)appendData:(NSData*)other;
//為已經存在的data追加新的長度
- (void)increaseLengthBy:(NSUInteger)extraLength;
示例程序：
NSMutableData * data = [NSMutableData data];
[data increaseLengthBy:5];
NSLog(@"dataLength———%lu",(unsigned long)data.length);
//給data替換對應位置的字節
- (void)replaceBytesInRange:(NSRange)range withBytes:(constvoid*)bytes;
//重置可變data對應位置的字節
- (void)resetBytesInRange:(NSRange)range;
//為可變data設置data數據
- (void)setData:(NSData*)data;
//給data替換對應位置的字節, 并且存在替換長度
- (void)replaceBytesInRange:(NSRange)range withBytes:(constvoid*)replacementBytes length:(NSUInteger)replacementLength;
@end
@interface NSMutableData (NSMutableDataCreation)
//動態創建可變data并且初始化指定大小
+ (instancetype)dataWithCapacity:(NSUInteger)aNumItems;
//動態創建可變data并且初始化指定長度
+ (instancetype)dataWithLength:(NSUInteger)length;
//靜態創建可變data并且初始化指定大小
- (instancetype)initWithCapacity:(NSUInteger)capacity;
//靜態創建可變data并且初始化指定長度
- (instancetype)initWithLength:(NSUInteger)length;
@end
//data讀取過程的可選配置條件
typedef NS_OPTIONS(NSUInteger, NSDataReadingOptions) {
NSDataReadingMappedIfSafe =1UL <<0,NSDataReadingUncached =1UL <<1,
NSDataReadingMappedAlwaysNS_ENUM_AVAILABLE(10_7,5_0) =1UL <<3,
NSDataReadingMapped =NSDataReadingMappedIfSafe,// Deprecated name for NSDataReadingMappedIfSafe
NSMappedRead =NSDataReadingMapped,// Deprecated name for NSDataReadingMapped
NSUncachedRead =NSDataReadingUncached// Deprecated name for NSDataReadingUncached
};
//data寫入過程的可選配置條件
typedef NS_OPTIONS(NSUInteger, NSDataWritingOptions) {
NSDataWritingAtomic =1UL <<0,
NSDataWritingWithoutOverwritingNS_ENUM_AVAILABLE(10_8,6_0) =1UL <<1,
NSDataWritingFileProtectionNoneNS_ENUM_AVAILABLE_IOS(4_0)? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? =0x10000000,
NSDataWritingFileProtectionCompleteNS_ENUM_AVAILABLE_IOS(4_0)? ? ? ? ? ? ? ? ? ? ? ? ? ? ? =0x20000000,
NSDataWritingFileProtectionCompleteUnlessOpenNS_ENUM_AVAILABLE_IOS(5_0)? ? ? ? ? ? ? ? ? ? =0x30000000,
NSDataWritingFileProtectionCompleteUntilFirstUserAuthenticationNS_ENUM_AVAILABLE_IOS(5_0)? =0x40000000,
NSDataWritingFileProtectionMaskNS_ENUM_AVAILABLE_IOS(4_0)? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? =0xf0000000,
NSAtomicWrite =NSDataWritingAtomic
};
/****************Data Search Options****************/
//data在搜索過程中的可選配置條件
typedef NS_OPTIONS(NSUInteger, NSDataSearchOptions) {
NSDataSearchBackwards =1UL <<0,
NSDataSearchAnchored =1UL <<1
}NS_ENUM_AVAILABLE(10_6,4_0);
/***下方為已廢棄代碼，不多做解釋***/
@interface NSData (NSDeprecated)
- (void)getBytes:(void*)bufferNS_DEPRECATED(10_0,10_10,2_0,8_0,"This method is unsafe because it could potentially cause buffer overruns. Use -getBytes:length: instead.");
+ (id)dataWithContentsOfMappedFile:(NSString*)pathNS_DEPRECATED(10_0,10_10,2_0,8_0,"Use +dataWithContentsOfURL:options:error: and NSDataReadingMappedIfSafe or NSDataReadingMappedAlways instead.");
- (id)initWithContentsOfMappedFile:(NSString*)pathNS_DEPRECATED(10_0,10_10,2_0,8_0,"Use -initWithContentsOfURL:options:error: and NSDataReadingMappedIfSafe or NSDataReadingMappedAlways instead.");
- (id)initWithBase64Encoding:(NSString*)base64StringNS_DEPRECATED(10_6,10_9,4_0,7_0);
- (NSString*)base64EncodingNS_DEPRECATED(10_6,10_9,4_0,7_0);
@end
/****************Purgeable Data****************/
NS_CLASS_AVAILABLE(10_6,4_0)
@interfaceNSPurgeableData :NSMutableData {
@private
NSUInteger_length;
int32_t_accessCount;
uint8_t_private[32];
void*_reserved;
}
@end
