Objective-C NSData/NSMutableData

创建于完成: 2018/02/06

 


总览: http://www.cnblogs.com/lancgg/p/8404975.html 

 数据类 
 简介

 处理比特列

 Foundation/NSData.h 

 (1)

 生成

 

 - (id) initWithBytes: (const void *) bytes length: (NSUInteger) length

 便利的构造函数:

 dataWithBytes:length:

 以bytes为起点长度length的数据来初始化

 是copy,不是原来对象

 - (id) initWithBytesNoCopy: (void *) bytes

            length: (unsigned) length

       freeWhenDone: (BOOL) flag

 便利的构造函数:

 dataWithBytesNoCopy:length:freeWhenDone:

 以bytes为起点长度length的数据来初始化 

 不是copy,是原来对象

 flag: YES 自动释放, bytes必须有malloc等生成

         NO 手动释放

 - (id) initWithData: (NSData *) aData

 便利的构造函数:

 dataWithData:

 从aData生成

 aData可以使NSMutableData的实例, 从可变生成不变

 + (id) data

 相当于 [[NSData alloc] init];

 生成长度0的空的NSData实例

 主要用于NSMutableData, 对应init

   

 

 (2)

 获取

  

 - (NSUInteger) length  获取比特列长度
 - (const void *) bytes  获取比特列开头的指针

 - (void) getBytes: (void *) buffer length: (NSUInteger) length

 获取开头开始长度length的比特列

 - (NSData *) subdataWithRange: (NSRange) range

 - (void) getBytes: (void) buffer range: (NSRange) range

 获取range范围的数据

 把range范围的数据写入buffer

 - (NSRange) rangeOfData: (NSData *) dataToFind

             options: (NSDataSearchOptions) mask

           range: (NSRange) searchRange

 在searchRange范围内寻找dataToFind,找到

 返回NSRange类数据。

 NSDataSearchOptions可以指定逆序查找等

 dataToFind不可以是nil

   
   
   

 

 (3)

 比较 

 

 - (BOOL) isEqualToData: (id) anObject  受体的data和anObject内容一致,长度一致时返回YES
   

 

 (4)

 文件输入输出 

  

 - (NSString *) description  把data的内容以property list形式生成字符串并返回

 - (id) initWithContentsOfFile: (NSString *) path

            options: (NSUInteger) mask

               error: (NSError **) errorPtr

 便利的构造函数:

 dataWithContentsOfFile:options:error:

 读取path文件,作为比特列来初始化

 失败的话受体自动释放,变成nil, errorPtr装入详细错误信息

 mask: 是否使用虚拟内存等? # TODO: check [mask内容?]

 - (id) initWithContentsOfFile: (NSString *) path

 便利的构造函数:

 dataWithContensOfFile:

 上一个的第二,三参数自动指定为0, NULL

 - (BOOL) writeToFile: (NSString *) path

                atomically: (BOOL) flag

 把受体的比特列写入path指定的文件里,成功返回YES

 flag: YES 写入在临时文件,成功后重命名为指定文件 (失败不影响原文件)  

   
   
   
   
   
   

 

NSMutableData 

 NSData的子类

 Foundation/NSData.h

 (1)

 生成

 

 - (id) initWithCapacity: (NSUInteger) capacity

 便利的构造函数:

 dataWithCapacity

 指定容量来生成, 不够了自动增加

 也可以直接init, 也就是容量为0

 - (id) initWithLength: (NSUInteger) capacity

 便利的构造函数:

 dataWithLength:

 指定比特列长度来生成, 全部比特位用0来填
   
   
   

 

 (2)

 获取

 

 - (void *) mutableBytes

 获取比特列

 长度为0时返回NULL

 和bytes的不同在于获取的比特列可以被改写

   
   

 

 (3)

 增加

  

 - (void) appendData: (NSData *) otherData  在受体的比特列末尾添加上otherData(copy)

 - (void) appendBytes: (const void *) bytes

         length: (NSUInteger) length

 复制bytes开头到指定长度的比特列到受体末尾

 # TODO: check [长度超过bytes时候是什么处理]

   

 

 (4)

 变更

 

 - (void) replaceByBytesInRange: (NSRange) range

            withBytes: (const void *) replacementBytes

               length: (NSUInteger) replacementLength

 用replacementBytes替换range指定的范围

 replacementLength是替换的新字符串的长度

 range的长度和replacementLength不同的话,比特列长度自动变化。

 range的长度为0时为location后插入

 - (void) replaceBytesInRange: (NSRange) range

                             withBytes: (const void *) bytes

  用bytes替换range指定范围的数据

 相当于上一个的replacementLength和range的length相同的情况

 - (void) setData: (NSData *) aData  用aData的内容设置受体
 - (void) resetBytesInRange: (NSRange) range  用0重置指定范围的比特列
   

 

 (5)

 改变比特列长度

 

 - (void) increaseLengthBy: (NSUInteger) extraLength

 增加指定长度

 增加部分都自动用0填埋

 - (void) setLength: (NSUInteger) length

 设定比特列长度为length

 拉伸的时候,增加部分自动用0填埋

   

 

 

   
   
   
   
posted @ 2018-02-06 12:18  懒虫哥哥  阅读(524)  评论(0编辑  收藏  举报