【OC梳理】NSPointerArray、NSMapTable、NSHashTable

NSPointerArray、NSMapTable、NSHashTable是iOS 6.0之后新增的集合类型,对应于原来的NSArray、NSSet、NSDictionary。

NSPointerArray

NSPointerArray和NSArray/NSMutableArray一样,用于有序的插入或移除。不同的是:

  • 可以存储 nil,并且 nil 还参与 count 的计算。
  • count 值可以直接设置,如果直接设置count,那么会使用 nil 占位。
  • 可以使用 weak 来修饰元素,可以添加所有的指针类型。
  • 可以通过 for...in 来进行遍历。

也有一些缺点:

  • 操作均基于 index,无法通过 object 来进行操作;
  • 无法直接插入 array,或用 array 初始化;
  • 查找功能没有 NSArray 强大;
  • 没有逆序、排序等 API 提供

初始化

NSPointerArray 有两个初始化方法:

- (instancetype)initWithOptions:(NSPointerFunctionsOptions)options;
- (instancetype)initWithPointerFunctions:(NSPointerFunctions *)functions; 

+ (NSPointerArray *)pointerArrayWithOptions:(NSPointerFunctionsOptions)options;
+ (NSPointerArray *)pointerArrayWithPointerFunctions:(NSPointerFunctions *)functions;

NSPointerFunctionsOptions主要分为三大类:

内存管理

  • NSPointerFunctionsStrongMemory:缺省值,在 CG 和 MRC 下强引用成员
  • NSPointerFunctionsZeroingWeakMemory:已废弃,在 GC 下,弱引用指针,防止悬挂指针
  • NSPointerFunctionsMallocMemory 与 NSPointerFunctionsMachVirtualMemory:3 用于 Mach 的虚拟内存管理
  • NSPointerFunctionsWeakMemory:在 CG 或者 ARC 下,弱引用成员

特性,用于标明对象判等方式

  • NSPointerFunctionsObjectPersonality:hash、isEqual、对象描述
  • NSPointerFunctionsOpaquePersonality:pointer 的 hash 、直接判等
  • NSPointerFunctionsObjectPointerPersonality:pointer 的 hash、直接判等、对象描述
  • NSPointerFunctionsCStringPersonality:string 的 hash、strcmp 函数、UTF-8 编码方式的描述
  • NSPointerFunctionsStructPersonality:内存 hash、memcmp 函数
  • NSPointerFunctionsIntegerPersonality:值的 hash

内存标识

  • NSPointerFunctionsCopyIn:根据第二类的选择,来具体处理。

可以使用多个组合进行初始化:

NSPointerFunctionsOptions opt = NSPointerFunctionsStrongMemory | NSPointerFunctionsObjectPersonality | NSPointerFunctionsCopyIn;
NSPointerArray *point = [[NSPointerArray alloc]initWithOptions:opt];

NSPointerFunctions
使用NSPointerFunctions可以自定义NSPointerArray对元素的处理方式:如何内存管理、如何hash、如何判断相等(isEqual)。
NSPointerFunctions初始化时可设置NSPointerFunctionsOptions

- (instancetype)initWithOptions:(NSPointerFunctionsOptions)options;
+ (NSPointerFunctions *)pointerFunctionsWithOptions:(NSPointerFunctionsOptions)options;

如果需要自定义实现函数,可以使用下面的对应属性:

// 自定义指针函数
// hash函数
@property (nullable) NSUInteger (*hashFunction)(const void *item, NSUInteger (* _Nullable size)(const void *item));
// isEqual函数
@property (nullable) BOOL (*isEqualFunction)(const void *item1, const void*item2, NSUInteger (* _Nullable size)(const void *item));
// size函数
@property (nullable) NSUInteger (*sizeFunction)(const void *item);
// 描述函数
@property (nullable) NSString * _Nullable (*descriptionFunction)(const void *item);

// 自定义内存配置
// 移除元素时的处理函数
@property (nullable) void (*relinquishFunction)(const void *item, NSUInteger (* _Nullable size)(const void *item));
// 添加元素时的处理函数
@property (nullable) void * _Nonnull (*acquireFunction)(const void *src, NSUInteger (* _Nullable size)(const void *item), BOOL shouldCopy);

可以自行实现函数,然后将函数指针赋给对应属性即可,比如,isEqual:

static BOOL IsEqual(const void *item1, const void *item2, NSUInteger (*size)(const void *item)) {
    return *(const int *)item1 == *(const int *)item2;
}

NSPointerFunctions *functions = [[NSPointerFunctions alloc] init];
[functions setIsEqualFunction:IsEqual]; 

操作数组

添加元素:

- (void)addPointer:(nullable void *)pointer;

移除元素:

- (void)removePointerAtIndex:(NSUInteger)index; 

插入元素:

- (void)insertPointer:(nullable void *)item atIndex:(NSUInteger)index;

替换元素:

- (void)replacePointerAtIndex:(NSUInteger)index withPointer:(nullable void *)item;

如果想实现类似Array的根据下标赋值,可以为它添加一个分类:


@interface NSPointerArray(Set)

/// 设置目标位置的值
- (void)setObject:(id)anObject
          atIndex:(NSUInteger)idx;

@end

@implementation NSPointerArray(Set)

- (void)setObject:(id)anObject
          atIndex:(NSUInteger)idx{
    if (self.count > idx) {
       self.count = idx + 2;
    }
    [self insertPointer:(__bridge void * _Nullable)(anObject) atIndex:idx];
}

@end

NSMapTable

与 NSMapTable 对应的,是 NSMutableDictionary。除了 集合的共有特点以外,比起传统字典,它还有一些优势:

  • key 可以不用遵循 NSCopying 协议;
  • key 和 value 的内存管理方式可以分开,如:key 是强引用,value 是弱引用;

相比起 NSPointerArray,NSMapTable 的初始化方法要多得多:

// 虽然有 capacity 参数,但实际没用到
- (instancetype)initWithKeyOptions:(NSPointerFunctionsOptions)keyOptions valueOptions:(NSPointerFunctionsOptions)valueOptions capacity:(NSUInteger)initialCapacity;
- (instancetype)initWithKeyPointerFunctions:(NSPointerFunctions *)keyFunctions valuePointerFunctions:(NSPointerFunctions *)valueFunctions capacity:(NSUInteger)initialCapacity;
 
+ (NSMapTable *)mapTableWithKeyOptions:(NSPointerFunctionsOptions)keyOptions valueOptions:(NSPointerFunctionsOptions)valueOptions;
 
// 返回指定 key、value 内存管理类型的 map
+ (NSMapTable *)strongToStrongObjectsMapTable NS_AVAILABLE(10_8, 6_0);
+ (NSMapTable *)weakToStrongObjectsMapTable NS_AVAILABLE(10_8, 6_0);
+ (NSMapTable *)strongToWeakObjectsMapTable NS_AVAILABLE(10_8, 6_0);
+ (NSMapTable *)weakToWeakObjectsMapTable NS_AVAILABLE(10_8, 6_0);

其实,这么多的初始化方法就对应着四种搭配:

  • key 为 strong,value 为 strong
  • key 为 strong,value 为 weak
  • key 为 weak,value 为 strong
  • key 为 weak,value 为 weak

当用 weak 修饰 key 或 value 时,有一方被释放,则该键值对移除。

NSHashTable

NSHashTable 对应 NSMutableSet,它的 API 更为简单,与 NSMapTable 同样,初始化方法的 capacity 并未生效。

- (instancetype)initWithOptions:(NSPointerFunctionsOptions)options capacity:(NSUInteger)initialCapacity;
- (instancetype)initWithPointerFunctions:(NSPointerFunctions *)functions capacity:(NSUInteger)initialCapacity;

值得注意的是,NSHashTable 有一个 allObjectes 的属性,返回 NSArray,即使 NSHashTable 是弱引用成员,allObjects 依然会对成员进行强引用。

你可能感兴趣的:(【OC梳理】NSPointerArray、NSMapTable、NSHashTable)