NSIndexSet译

文档

起语

希望听到不一样的声音

概况

NSIndexSet类代表由无符号整数组成的不可变集合。元素的范围是从0到NSNotFound - 1。

你可以使用索引集合去存储一些数据结构的索引。比如：可以用索引集合去表现一个数组的子数组。

You should not use index sets to store an arbitrary collection of integer values because index sets store indexes as sorted ranges.

你不应该使用索引集合去存储一个任意的整数集合，因为索引集合是使用经过排序的Range来做到存储索引的。这样比单个存储数字的集合更加高效。它也意味着每个索引元素只会出现一次。

NSIndexSet类有三个初始化函数，分别为：init，init(indexesIn:)，和init(indexSet:)。

不能子类化NSIndexSet。

可变的索引集合为NSNutableIndexSet。

重点
在Swift中Foundation框架提供的IndexSet数据结构，是桥接的NSIndexSet类和NSMutableIndexSet。

API

初始化

可以使用单个索引、范围（NSRange）、索引集合（IndexSet）初始化

查寻

可以查看集合中是否包含某个索引，可以查看两个索引集合是否包含相同索引，查看集合是否包含某个范围，可以查看集合元素数量，同时也可以查看某个范围内索引的数量，同时还支持使用高阶函数。

使用高阶函数可以查寻符合某个条件的第一个索引，查寻符合某个条件的所有索引（以IndexSet形式返回），还可以通过指定查寻范围和枚举方式（NSEnumerationOptions）来做以上两种查寻。

枚举内容

可以枚举所有的范围，同时支持指定进行枚举的范围和枚举的方式。

比较

可以比较两个集合是否相等。

获取元素

可以取得第一个，最后一个，比某个元素小或者小于等于的第一个，比某个元素大或大于等于的第一个。

getIndexes(_:maxCount:inIndexRange:)

The index set fills an index buffer with the indexes contained both in the index set and in an index range, returning the number of indexes copied.

同时，也可以得到某个位置的范围（毕竟IndexSet是NSRange的集合），以及可以得到range的个数。

可以得到范围内索引的数量，同时可以通过buffer拿到这些索引，还可以通过bufferSize控制拿到索引的数量

枚举索引

可以依次枚举各个索引，也可以指定枚举的类型和枚举的范围

可以得到一个迭代器（NSIndexSetIterator），来自己做迭代。

尾语

想到了NSIndexPath可以对比下异同。