Foundition API - NSArray学习

第一次学习英文官方文档，有很多不懂得地方，暂时空着，回头查询中文文档再补全，如果有大神愿意指点，请留言，感谢！！！

1、创建一个Array

//1>创建一个空数组
+ (instancetype)array;
//demo
NSArray *arr = [NSArray array];

//2>创建并返回一个数组，这个数组拥有另一个数组中的对象
+ (instancetype)arrayWithArray:(NSArray<ObjectType> *)array;
//demo
NSArray *arr = [NSArray arrayWithArray:arr1];

//3>创建并返回一个数组，这个数组中包含路径指定文件中的内容
+ (NSArray<ObjectType> *)arrayWithContentsOfFile:(NSString *)path;
//demo
NSArray *arr = [NSArray arrayWithContentsOfFile:path];

//4>创建并返回一个数组，这个数组中包含指定url中的内容
+ (NSArray<ObjectType> *)arrayWithContentsOfURL:(NSURL *)url;
//demo
NSArray *arr = [NSArray arrayWithContentsOfURL:url];

//5>创建并返回一个数组，这个数组中包含一个指定的对象
+ (instancetype)arrayWithObject:(ObjectType)anObject;
//demo
NSArray *arr = [NSArray arrayWithObject:@"one"];

//6>创建并返回一个数组，这个数组中包含一列对象
+ (instancetype)arrayWithObjects:(ObjectType)firstObj, ...;
//demo
NSArray *arr = [NSArray arrayWithObjects:@"one", @"two", @"three", nil];

//7>没用过
+ (instancetype)arrayWithObjects:(const ObjectType  _Nonnull [])objects count:(NSUInteger)cnt;

2>初始化一个数组

//1>初始化一个最新分配内存的数组
- (instancetype)init;
//demo
NSArray *arr = [[NSArray alloc] init];

//2>初始化一个最新分配内存的数组，这个数组拥有另一个数组中的对象
- (instancetype)initWithArray:(NSArray<ObjectType> *)array;
//demo
NSArray *arr = [[NSArray alloc] initWithArray:arr1];

//3>初始化一个最新分配内存的数组，这个数组拥有另一个数组中的对象，并可选择是否copy数组中对象
- (instancetype)initWithArray:(NSArray<ObjectType> *)array copyItems:(BOOL)flag;
//demo
NSArray *arr = [[NSArray alloc] initWithArray:arr1 copyItems:YES];

//4>初始化一个最新分配内存的数组，这个数组中包含指定路径下文件的内容
- (NSArray<ObjectType> *)initWithContentsOfFile:(NSString *)path;
//demo
NSArray *arr = [[NSArray alloc] initWithContentsOfFile:path];

//5>初始化一个最新分配内存的数组，这个数组中包含指定url中的内容
- (NSArray<ObjectType> *)initWithContentsOfURL:(NSURL *)url;
//demo
NSArray *arr = [[NSArray alloc] initWithContentsOfURL:url];

//6>初始化一个最新分配内存的数组，这个数组中包含一列对象
- (instancetype)initWithObjects:(ObjectType)firstObj, ...;
//demo
NSArray *arr = [NSArray arrayWithObjects:@"one", @"two", @"three", nil];

//7>没用过
- (instancetype)initWithObjects:(ObjectType  _Nonnull const [])objects count:(NSUInteger)cnt;

3、查询一个字典

//1>判断数组中是否包含指定对象
- (BOOL)containsObject:(ObjectType)anObject;
//demo
NSArray *arr1 = @[@"1",@"2",@"3"];
BOOL isContain = [arr1 containsObject:@"1"];
NSLog(@"isContain = %d",isContain);//isContain = 1

//2>判断数组中对象的数量
@property(readonly) NSUInteger count;
//demo
NSUInteger num = arr1.count;

//3>
- (void)getObjects:(ObjectType  _Nonnull [])objects;

//4>
- (void)getObjects:(ObjectType  _Nonnull [])objects range:(NSRange)range;

//5>获取数组中第一个对象
@property(nonatomic, readonly) ObjectType firstObject;

//6>获取数组中最后一个对象
@property(nonatomic, readonly) ObjectType lastObject;

//7>获取数组中指定位置的对象
- (ObjectType)objectAtIndex:(NSUInteger)index;
//demo
ObjectType obj = [arr1 objectAtIndex:1];

//8>获取数组中指定位置的对象
- (ObjectType)objectAtIndexedSubscript:(NSUInteger)idx;

//9>获取索引集合中所有索引对应位置的对象，组成新的数组
- (NSArray<ObjectType> *)objectsAtIndexes:(NSIndexSet *)indexes;
//demo
NSArray *arr1 = @[@"1",@"2",@"3"];
NSMutableIndexSet *set = [NSMutableIndexSet indexSet];
[set addIndex:0];
[set addIndex:2];
NSArray *arr2 = [arr1 objectsAtIndexes:set];// (1,3)

//10>数组转化为枚举类型
- (NSEnumerator<ObjectType> *)objectEnumerator;

4、查询数组中相应对象的位置(建议使用前先判断是否存在，然后查询位置)

//1>返回数组中与给定的对象相等对象的最小索引
- (NSUInteger)indexOfObject:(ObjectType)anObject;
//demo
NSArray *arr = @[@"1",@"2",@"3"];
NSUInteger index = [arr indexOfObject:@"1"];

//2>返回数组中特定范围内与给定的对象相等对象的最小索引
- (NSUInteger)indexOfObject:(ObjectType)anObject inRange:(NSRange)range;
//demo
NSArray *arr = @[@"1",@"2",@"3"];
NSInteger index1 = [arr indexOfObject:@"3" inRange:NSMakeRange(2, 1)];

//3>返回数组中与给定的对象完全相同对象的最小索引
- (NSUInteger)indexOfObjectIdenticalTo:(ObjectType)anObject;
//demo
NSArray *arr1 = [[NSArray alloc] initWithObjects:@"1", nil];
NSArray *arr2 = [[NSArray alloc] initWithObjects:@"1", @"2", nil];
NSArray *arr3 = [[NSArray alloc] initWithObjects:@"1", @"2", @"3", nil];
NSArray *arr = @[arr1,arr2,arr3];
NSInteger index1 = [arr indexOfObjectIdenticalTo:arr1];

//4>返回数组中特定范围内与给定的对象完全相同对象的最小索引
- (NSUInteger)indexOfObjectIdenticalTo:(ObjectType)anObject inRange:(NSRange)range;
//demo
NSArray *arr1 = [[NSArray alloc] initWithObjects:@"1", nil];
NSArray *arr2 = [[NSArray alloc] initWithObjects:@"1", @"2", nil];
NSArray *arr3 = [[NSArray alloc] initWithObjects:@"1", @"2", @"3", nil];
NSArray *arr = @[arr1,arr2,arr3];
NSInteger index2 = [arr indexOfObjectIdenticalTo:arr1 inRange:NSMakeRange(0, 2)];

//5>
- (NSUInteger)indexOfObjectPassingTest:(BOOL (^)(ObjectType obj, NSUInteger idx, BOOL *stop))predicate;

//6>
- (NSUInteger)indexOfObjectWithOptions:(NSEnumerationOptions)opts passingTest:(BOOL (^)(ObjectType obj, NSUInteger idx, BOOL *stop))predicate;

//7>
- (NSUInteger)indexOfObjectAtIndexes:(NSIndexSet *)s options:(NSEnumerationOptions)opts passingTest:(BOOL (^)(ObjectType obj, NSUInteger idx, BOOL *stop))predicate;

//8>
- (NSIndexSet *)indexesOfObjectsPassingTest:(BOOL (^)(ObjectType obj, NSUInteger idx, BOOL *stop))predicate;

//9>
- (NSIndexSet *)indexesOfObjectsWithOptions:(NSEnumerationOptions)opts passingTest:(BOOL (^)(ObjectType obj, NSUInteger idx, BOOL *stop))predicate;

//10>
- (NSIndexSet *)indexesOfObjectsAtIndexes:(NSIndexSet *)s options:(NSEnumerationOptions)opts passingTest:(BOOL (^)(ObjectType obj, NSUInteger idx, BOOL *stop))predicate;

//11>
- (NSUInteger)indexOfObject:(ObjectType)obj inSortedRange:(NSRange)r options:(NSBinarySearchingOptions)opts usingComparator:(NSComparator)cmp;

5、Sending Message to Elements

//1>
- (void)makeObjectsPerformSelector:(SEL)aSelector;

//2>
- (void)makeObjectsPerformSelector:(SEL)aSelector withObject:(id)argument;

//3>
- (void)enumerateObjectsUsingBlock:(void (^)(ObjectType obj, NSUInteger idx, BOOL *stop))block;

//4>
- (void)enumerateObjectsWithOptions:(NSEnumerationOptions)opts usingBlock:(void (^)(ObjectType obj, NSUInteger idx, BOOL *stop))block;

//5>
- (void)enumerateObjectsAtIndexes:(NSIndexSet *)s options:(NSEnumerationOptions)opts usingBlock:(void (^)(ObjectType obj, NSUInteger idx, BOOL *stop))block;

6、数组比较

//1>返回两个数组中第一个相等的对象
- (ObjectType)firstObjectCommonWithArray:(NSArray<ObjectType> *)otherArray;

//2>比较两个数组是否相等
- (BOOL)isEqualToArray:(NSArray<ObjectType> *)otherArray;

7、得到新的数组

//1>拷贝一个数组，在其末尾增加一个对象并返回
- (NSArray<ObjectType> *)arrayByAddingObject:(ObjectType)anObject;
//demo
NSArray *arr4 = [arr1 arrayByAddingObject:@"4"];

//2>拷贝一个数组，在其末尾增加另一个数组的所有对象并返回
- (NSArray<ObjectType> *)arrayByAddingObjectsFromArray:(NSArray<ObjectType> *)otherArray;

//3>
- (NSArray<ObjectType> *)filteredArrayUsingPredicate:(NSPredicate *)predicate;

//4>复制数组中给定范围内的对象，并作为新数组返回
- (NSArray<ObjectType> *)subarrayWithRange:(NSRange)range;
//demo
NSArray *arr3 = [[NSArray alloc] initWithObjects:@"1", @"2", @"3", nil]; 
NSArray *arr4 = [arr3 subarrayWithRange:NSMakeRange(0, 2)];

8、排序

//1>
@property(readonly, copy) NSData *sortedArrayHint;

//2>
- (NSArray<ObjectType> *)sortedArrayUsingFunction:(NSInteger (*)(ObjectType, ObjectType, void *))comparator context:(void *)context;

//3>
- (NSArray<ObjectType> *)sortedArrayUsingFunction:(NSInteger (*)(ObjectType, ObjectType, void *))comparator context:(void *)context hint:(NSData *)hint;

//4>
- (NSArray<ObjectType> *)sortedArrayUsingDescriptors:(NSArray<NSSortDescriptor *> *)sortDescriptors;

//5>
- (NSArray<ObjectType> *)sortedArrayUsingSelector:(SEL)comparator;

//6>
- (NSArray<ObjectType> *)sortedArrayUsingComparator:(NSComparator)cmptr;


//7>
- (NSArray<ObjectType> *)sortedArrayWithOptions:(NSSortOptions)opts usingComparator:(NSComparator)cmptr;

9、用字符串拼接数组

- (NSString *)componentsJoinedByString:(NSString *)separator;
//demo
NSArray *arr4 = [[NSArray alloc] initWithObjects:@"2", @"1", @"3", nil];
NSString *str = [arr4 componentsJoinedByString:@","];

10、创建描述

//1>
@property(readonly, copy) NSString *description;

//2>
- (NSString *)descriptionWithLocale:(id)locale;

//3>
- (NSString *)descriptionWithLocale:(id)locale indent:(NSUInteger)level;

11、存储数组

//1>将数组存入指定的路径文件下
- (BOOL)writeToFile:(NSString *)path atomically:(BOOL)useAuxiliaryFile;

//2>将数组存入指定的url中
- (BOOL)writeToURL:(NSURL *)url atomically:(BOOL)atomically;

12、收集路径

- (NSArray<NSString *> *)pathsMatchingExtensions:(NSArray<NSString *> *)filterTypes;

13、观察者模式（Key-Value Observing）
使用：http://www.jianshu.com/p/b0c30891f1bf

//1>添加观察者
- (void)addObserver:(NSObject *)observer forKeyPath:(NSString *)keyPath options:(NSKeyValueObservingOptions)options context:(void *)context;
//demo
[_a addObserver:_b forKeyPath:@"name" options:NSKeyValueObservingOptionNew|NSKeyValueObservingOptionOld context:NULL];

//2>移除观察者
- (void)removeObserver:(NSObject *)observer forKeyPath:(NSString *)keyPath;
//demo
[_a removeObserver:_b forKeyPath:@"name"];

//3>移除观察者
- (void)removeObserver:(NSObject *)observer forKeyPath:(NSString *)keyPath context:(void *)context;
//demo
[_a removeObserver:_b forKeyPath:@"name" context:NULL];

//4>移除观察者
- (void)removeObserver:(NSObject *)observer fromObjectsAtIndexes:(NSIndexSet *)indexes forKeyPath:(NSString *)keyPath context:(void *)context;

//5>添加观察者
- (void)addObserver:(NSObject *)observer toObjectsAtIndexes:(NSIndexSet *)indexes forKeyPath:(NSString *)keyPath options:(NSKeyValueObservingOptions)options context:(void *)context;

//6>移除观察者
- (void)removeObserver:(NSObject *)observer fromObjectsAtIndexes:(NSIndexSet *)indexes forKeyPath:(NSString *)keyPath;

14、键-值编码(Key-Value Coding)

//1>写值
- (void)setValue:(id)value forKey:(NSString *)key;

//2>取值
- (id)valueForKey:(NSString *)key;

15、Randomly Shuffling an Array

//1>
- (NSArray<ObjectType> *)shuffledArray;

//2>
- (NSArray<ObjectType> *)shuffledArrayWithRandomSource:(GKRandomSource *)randomSource;

16、新方法

- (instancetype)initWithCoder:(NSCoder *)aDecoder;

最后编辑于：2017.12.05 11:25:52

人面猴
序言：七十年代末，一起剥皮案震惊了整个滨河市，随后出现的几起案子，更是在滨河造成了极大的恐慌，老刑警刘岩，带你破解...
沈念sama阅读 204,590评论 6赞 478
死咒
序言：滨河连续发生了三起死亡事件，死亡现场离奇诡异，居然都是意外死亡，警方通过查阅死者的电脑和手机，发现死者居然都...
沈念sama阅读 86,808评论 2赞 381
救了他两次的神仙让他今天三更去死
文/潘晓璐我一进店门，熙熙楼的掌柜王于贵愁眉苦脸地迎上来，“玉大人，你说我怎么就摊上这事。” “怎么了？”我有些...
开封第一讲书人阅读 151,151评论 0赞 337
道士缉凶录：失踪的卖姜人
文/不坏的土叔我叫张陵，是天一观的道长。经常有香客问我，道长，这世上最难降的妖魔是什么？我笑而不...
开封第一讲书人阅读 54,779评论 1赞 277
港岛之恋（遗憾婚礼）
正文为了忘掉前任，我火速办了婚礼，结果婚礼上，老公的妹妹穿的比我还像新娘。我一直安慰自己，他们只是感情好，可当我...
茶点故事阅读 63,773评论 5赞 367
恶毒庶女顶嫁案：这布局不是一般人想出来的
文/花漫我一把揭开白布。她就那样静静地躺着，像睡着了一般。火红的嫁衣衬着肌肤如雪。梳的纹丝不乱的头发上，一...
开封第一讲书人阅读 48,656评论 1赞 281
城市分裂传说
那天，我揣着相机与录音，去河边找鬼。笑死，一个胖子当着我的面吹牛，可吹牛的内容都是我干的。我是一名探鬼主播，决...
沈念sama阅读 38,022评论 3赞 398
双鸳鸯连环套：你想象不到人心有多黑
文/苍兰香墨我猛地睁开眼，长吁一口气：“原来是场噩梦啊……” “哼！你这毒妇竟也来了？” 一声冷哼从身侧响起，我...
开封第一讲书人阅读 36,678评论 0赞 258
万荣杀人案实录
序言：老挝万荣一对情侣失踪，失踪者是张志新（化名）和其女友刘颖，没想到半个月后，有当地人在树林里发现了一具尸体，经...
沈念sama阅读 41,038评论 1赞 299
护林员之死
正文独居荒郊野岭守林人离奇死亡，尸身上长有42处带血的脓包…… 初始之章·张勋以下内容为张勋视角年9月15日...
茶点故事阅读 35,659评论 2赞 321
白月光启示录
正文我和宋清朗相恋三年，在试婚纱的时候发现自己被绿了。大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
茶点故事阅读 37,756评论 1赞 330
活死人
序言：一个原本活蹦乱跳的男人离奇死亡，死状恐怖，灵堂内的尸体忽然破棺而出，到底是诈尸还是另有隐情，我是刑警宁泽，带...
沈念sama阅读 33,411评论 4赞 321
日本核电站爆炸内幕
正文年R本政府宣布，位于F岛的核电站，受9级特大地震影响，放射性物质发生泄漏。R本人自食恶果不足惜，却给世界环境...
茶点故事阅读 39,005评论 3赞 307
男人毒药：我在死后第九天来索命
文/蒙蒙一、第九天我趴在偏房一处隐蔽的房顶上张望。院中可真热闹，春花似锦、人声如沸。这庄子的主人今日做“春日...
开封第一讲书人阅读 29,973评论 0赞 19
一桩弑父案，背后竟有这般阴谋
文/苍兰香墨我抬头看了看天上的太阳。三九已至，却和暖如春，着一层夹袄步出监牢的瞬间，已是汗流浃背。一阵脚步声响...
开封第一讲书人阅读 31,203评论 1赞 260
情欲美人皮
我被黑心中介骗来泰国打工，没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留，地道东北人。一个月前我还...
沈念sama阅读 45,053评论 2赞 350
代替公主和亲
正文我出身青楼，却偏偏与公主长得像，于是被迫代替她去往敌国和亲。传闻我的和亲对象是个残疾皇子，可洞房花烛夜当晚...
茶点故事阅读 42,495评论 2赞 343

Foundition API - NSArray学习

推荐阅读更多精彩内容