NSMutableArray Class Reference

        NSMutableArray是NSArray的子类，在NSArray的基础上扩展了一系列接口，使不可变得NSArray数组成为可变的NSMutableArray数组。

关于NSArray的介绍详见我的另一篇博文NSArray Class Reference

---

初始化

+ arrayWithCapacity:
+ arrayWithContentsOfFile:
+ arrayWithContentsOfURL:
- init
- initWithCapacity:
- initWithContentsOfFile:
- initWithContentsOfURL:

#pragma mark 测试数据
- (NSString *)testData {

    // 获取应用中Document文件夹
    NSArray *paths = NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES);
    NSString *documentsDirectory = [paths objectAtIndex:0];

    // 测试数据
    NSArray *array = [NSArray arrayWithObjects:@"阳君", @"937447974", nil];
    NSString *filePath = [documentsDirectory stringByAppendingPathComponent:@"test.plist"];
    BOOL write = [array writeToFile:filePath atomically:YES]; // 输入写入
    NSLog(@"writeToFile:%d", write);

    return filePath;

}

#pragma mark 初始化
- (void)testCreatingAndInitializing {

    NSString *filePath = [self testData];

    // (+)创建
    NSMutableArray *mArray = [NSMutableArray arrayWithCapacity:1];
    // 根据文件路径创建数组
    mArray = [NSMutableArray arrayWithContentsOfFile:filePath];
    mArray = [NSMutableArray arrayWithContentsOfURL:[NSURL URLWithString:filePath]];

    // (-)创建
    mArray = [[NSMutableArray alloc] initWithCapacity:1];
    mArray = [[NSMutableArray alloc] initWithContentsOfFile:filePath];
    mArray = [[NSMutableArray alloc] initWithContentsOfURL:[NSURL URLWithString:filePath]];

}

 

增加

- addObject:
- addObjectsFromArray:
- insertObject:atIndex:
- insertObjects:atIndexes:

#pragma mark 增加数据
- (void)testAdding {

    NSMutableArray *mArray = [NSMutableArray array];

    // 增加单一数据
    [mArray addObject:@"阳君"];

    // 批量添加数据
    NSArray *array = [NSArray arrayWithObjects:@"1", @"2", nil];
    [mArray addObjectsFromArray:array];

    // 指定位置插入单一数据
    [mArray insertObject:@"IOS" atIndex:1];

    // 指定位置插入多个数据
    NSRange range = {1, array.count};
    NSIndexSet *indexSet = [[NSIndexSet alloc] initWithIndexesInRange:range];
    [mArray insertObjects:array atIndexes:indexSet];

}

 

删除

- removeAllObjects
- removeLastObject
- removeObject:
- removeObject:inRange:
- removeObjectAtIndex:
- removeObjectsAtIndexes:
- removeObjectIdenticalTo:
- removeObjectIdenticalTo:inRange:
- removeObjectsInArray:
- removeObjectsInRange:

#pragma mark 删除数据
- (void)testRemoving {

    NSMutableArray *mArray = [NSMutableArray arrayWithObjects:@"阳君", @"937447974", @"IOS", nil];

    // 删除所有元素
    [mArray removeAllObjects];

    // 删除最后一个元素
    mArray = [NSMutableArray arrayWithObjects:@"阳君", @"937447974", @"IOS", nil];
    [mArray removeLastObject];

    // 根据位置删除对象
    mArray = [NSMutableArray arrayWithObjects:@"阳君", @"937447974", @"IOS", nil];
    [mArray removeObjectAtIndex:0];

    // 根据数组删除对象
    mArray = [NSMutableArray arrayWithObjects:@"阳君", @"IOS", @"937447974", @"IOS", nil];
    NSArray *array = [NSArray arrayWithObjects:@"IOS",@"阳君", nil];
    [mArray removeObjectsInArray:array];

    // 根据对象删除
    mArray = [NSMutableArray arrayWithObjects:@"阳君", @"IOS", @"937447974", @"IOS", nil];
    [mArray removeObject:@"IOS"];
    // 或
    mArray = [NSMutableArray arrayWithObjects:@"阳君", @"IOS", @"937447974", @"IOS", nil];
    [mArray removeObjectIdenticalTo:@"IOS"];

    // 删除指定范围内的对象
    NSRange range = {0, 2};// 第0个位置开始，连续2个
    mArray = [NSMutableArray arrayWithObjects:@"阳君", @"IOS", @"937447974", @"IOS", nil];
    [mArray removeObject:@"IOS" inRange:range];
    // 或
    mArray = [NSMutableArray arrayWithObjects:@"阳君", @"IOS", @"937447974", @"IOS", nil];
    [mArray removeObjectIdenticalTo:@"IOS" inRange:range];

    // 删除指定NSRange范围内的对象，批量删除
    mArray = [NSMutableArray arrayWithObjects:@"阳君", @"937447974", @"IOS", nil];
    [mArray removeObjectsInRange:range];
    // 或
    mArray = [NSMutableArray arrayWithObjects:@"阳君", @"937447974", @"IOS", nil];
    NSIndexSet *indexSet = [NSIndexSet indexSetWithIndexesInRange:range];
    [mArray removeObjectsAtIndexes:indexSet];

}

 

替换

- replaceObjectAtIndex:withObject:
- setObject:atIndexedSubscript:
- replaceObjectsAtIndexes:withObjects:
- replaceObjectsInRange:withObjectsFromArray:range:
- replaceObjectsInRange:withObjectsFromArray:
- setArray:

#pragma mark 替换对象
- (void)testReplacing {

    NSMutableArray *mArray = [NSMutableArray arrayWithObjects:@"阳君", @"937447974", @"IOS", nil];
    NSArray *array = [NSArray arrayWithObjects:@"1", @"2", @"3", nil];
    NSRange range = {0, array.count};// 第0个位置开始，连续count个
    NSIndexSet *indexSet = [NSIndexSet indexSetWithIndexesInRange:range];

    // 指定位置替换对象
    [mArray replaceObjectAtIndex:0 withObject:@"yangj"];
    // or
    [mArray setObject:@"yangj" atIndexedSubscript:0];

    // 数组替换
    [mArray setArray:array];

    // 用array替换数组中指定位置的所有元素
    mArray = [NSMutableArray arrayWithObjects:@"阳君", @"937447974", @"IOS", nil];
    [mArray replaceObjectsInRange:range withObjectsFromArray:array];
    // or
    mArray = [NSMutableArray arrayWithObjects:@"阳君", @"937447974", @"IOS", nil];
    [mArray replaceObjectsAtIndexes:indexSet withObjects:array];

    // 局部替换，使用array中的部分元素替换目标数组指定位置的元素
    mArray = [NSMutableArray arrayWithObjects:@"阳君", @"937447974", @"IOS", nil];
    range.length = 2;
    [mArray replaceObjectsInRange:range withObjectsFromArray:array range:range];

}

 

过滤

- filterUsingPredicate:

#pragma mark 数组过滤
- (void)testFiltering {

    NSMutableArray *mArray = [NSMutableArray arrayWithObjects:@"阳君", @"937447974", @"IOS", nil];

    // 使用过滤器过滤数组中的元素
    NSPredicate *predicate = [NSPredicate predicateWithBlock:^BOOL(id  _Nonnull evaluatedObject, NSDictionary<NSString *,id> * _Nullable bindings) {
        NSLog(@"%@", evaluatedObject);
        if ([@"937447974" isEqualToString:evaluatedObject]) {
            return YES;
        }
        return NO;
    }];
    [mArray filterUsingPredicate:predicate];

}

 

排序

- exchangeObjectAtIndex:withObjectAtIndex:
- sortUsingDescriptors:
- sortUsingComparator:
- sortWithOptions:usingComparator:
- sortUsingFunction:context:
- sortUsingSelector:

#pragma mark 排序
- (void)testSorting {

    NSMutableArray *mArray = [NSMutableArray arrayWithObjects:@"阳君", @"937447974", @"IOS", nil];

    // 交换两个位置的数据
    [mArray exchangeObjectAtIndex:0 withObjectAtIndex:1];

    // 对象自带的方法排序
    [mArray sortUsingSelector:@selector(compare:)];

    // Function排序
    [mArray sortUsingFunction:mSortByFunction context:nil];

    // block排序
    [mArray sortUsingComparator:^NSComparisonResult(id  _Nonnull obj1, id  _Nonnull obj2) {
        return [obj1 compare:obj2];
    }];

    [mArray sortWithOptions:NSSortConcurrent usingComparator:^NSComparisonResult(id  _Nonnull obj1, id  _Nonnull obj2) {
        return [obj1 compare:obj2];
    }];

}

 

---

其他

参考资料

NSMutableArray Class Reference

 

文档修改记录

时间	描述
2015-10-15	根据IOS9的NSMutableArray API总结

 

---

版权所有：http://blog.csdn.net/y550918116j