NSArray 是 Cocoa 裡最常用的容器,但它有兩條鐵律必須先記住:只能裝 Objective-C 物件(不能放 C 基本型別或結構),以及不能放 nil——nil 在語意上代表「元素清單到此結束」,是唯一一個「放進去反而會截斷陣列」的值。
適合 NSString、NSNumber 這類已實作 compare: 的類:
NSArray *array = [NSArray arrayWithObjects:@"2", @"3", @"1", @"4", nil]; NSArray *sorted = [array sortedArrayUsingSelector:@selector(compare:)];
元素是模型物件時,自己實作一個比較方法,再傳 selector 進去。注意方法簽名必須回傳 NSComparisonResult:
- (NSComparisonResult)compareStudent:(Student *)stu {
NSComparisonResult result = [self.firstName compare:stu.firstName];
if (result == NSOrderedSame) {
result = [self.lastName compare:stu.lastName]; // 名字相同再比姓氏
}
return result;
}
NSArray *sorted = [array sortedArrayUsingSelector:@selector(compareStudent:)];
這種寫法等同 Java 的 compareTo:自己決定規則,但一定要實作那個方法。
不想為此專門開一個方法的話,用 block 更就地一點:
NSArray *sorted = [array sortedArrayUsingComparator:^NSComparisonResult(Student *obj1, Student *obj2) {
NSComparisonResult result = [obj1.firstName compare:obj2.firstName];
if (result == NSOrderedSame) {
result = [obj1.lastName compare:obj2.lastName];
}
return result;
}];
需要「先依 A 排序,A 相同再依 B,B 相同再依 C」時,用排序描述子最乾淨,而且可以直接寫 key path:
NSSortDescriptor *byBook = [NSSortDescriptor sortDescriptorWithKey:@"book.name" ascending:YES];
NSSortDescriptor *byFirstName = [NSSortDescriptor sortDescriptorWithKey:@"firstName" ascending:YES];
NSSortDescriptor *byLastName = [NSSortDescriptor sortDescriptorWithKey:@"lastName" ascending:YES];
NSArray *sorted = [array sortedArrayUsingDescriptors:
[NSArray arrayWithObjects:byBook, byFirstName, byLastName, nil]];
描述子的順序就是優先順序,第一順位排在最前面。book.name 這種 key path 寫法在巢狀模型上特別好用,也常搭配 NSPredicate 一起做過濾與排序。
// 建立 NSArray *empty = [NSArray array]; NSArray *one = [NSArray arrayWithObject:@"123"]; NSArray *many = [NSArray arrayWithObjects:@"a", @"b", nil]; // nil 是結束標記 NSArray *copied = [NSArray arrayWithArray:otherArray]; // 查詢 NSUInteger count = array.count; // 等同 [array count] BOOL has = [array containsObject:anObject]; id last = [array lastObject]; id obj = [array objectAtIndex:index]; // 新版可寫 array[index] NSUInteger idx = [array indexOfObject:anObject]; NSUInteger idx2 = [array indexOfObject:anObject inRange:range]; BOOL equal = [array isEqualToArray:otherArray]; id common = [array firstObjectCommonWithArray:otherArray];
// 讓每個元素都執行同一個方法 [array makeObjectsPerformSelector:@selector(release)]; // 實務上少用,見下方提醒 [array makeObjectsPerformSelector:@selector(setText:) withObject:@"hi"]; // 只支援一個參數 // 回傳新陣列(原陣列不變,NSArray 不可變) NSArray *added = [array arrayByAddingObject:anObject]; NSArray *merged = [array arrayByAddingObjectsFromArray:otherArray]; NSArray *part = [array subarrayWithRange:range]; // 拼接成字串 NSString *str = [array componentsJoinedByString:@","]; // 存檔 BOOL ok = [array writeToFile:path atomically:YES];
makeObjectsPerformSelector: 雖然方便,但因為 selector 是字串、編譯器不檢查參數型別,出錯時只會在執行期炸掉。若只是要對每個元素做同一件事,優先考慮 enumerateObjectsUsingBlock: 更安全。
NSArray *array = [NSArray arrayWithObjects:@"1", @"2", @"3", nil];
for (int i = 0; i < array.count; i++) {
NSLog(@"%i-%@", i, [array objectAtIndex:i]);
}
for (id obj in array) {
NSLog(@"%@", obj);
}
enumerateObjectsUsingBlock: 的 block 有三個參數:元素、索引,以及一個 BOOL *stop。把 stop 設為 YES 即可提前中止:
[array enumerateObjectsUsingBlock:^(id obj, NSUInteger idx, BOOL *stop) {
NSLog(@"%zi->%@", idx, obj);
if ([obj isEqualToString:@"2"]) {
*stop = YES; // 找到就收工
}
}];
官方文件特別強調 stop 是 out-only 參數,block 內只應該「設為 YES」,不要讀它。若還想控制方向,改用帶 options 的版本:
[array enumerateObjectsWithOptions:NSEnumerationReverse usingBlock:^(id obj, NSUInteger idx, BOOL *stop) {
NSLog(@"%@,%lu", obj, (unsigned long)idx);
}];
常用選項還有 NSEnumerationConcurrent(併行枚舉,適合大量元素但要注意執行緒安全)。
NSEnumerator *e = [array objectEnumerator]; // 正序
// NSEnumerator *r = [array reverseObjectEnumerator]; // 反序
NSArray *all = [e allObjects]; // 注意:走訪之後再取會是空陣列
id obj = nil;
while (obj = [e nextObject]) {
NSLog(@"obj=%@", obj);
}
allObjects 會消耗掉迭代器,因此若想先取全部再逐個處理,順序必須對;或者乾脆直接用快速枚舉,語意更清楚。
NSArray 是不可變的,所有「新增、刪除、插入」的方法都會回傳一個新物件,呼叫者本身完全不變。若需要就地修改,請改用 NSMutableArray 的 addObject:、removeObjectAtIndex:、replaceObjectAtIndex:withObject:、exchangeObjectAtIndex:withObjectAtIndex: 等方法。實務上常見的誤解是把 [array arrayByAddingObject:] 當成「加進去」,結果原陣列還是舊的——回傳值沒接住就等於什麼都沒做。