版本记录

前言

NSArray是数组的不变数组类，不边数组在初始化的时候元素就是不变的，不能更改任何一个元素，实际上我们用的较多的是可变数组，因为很多时候我们都需要对数组元素进行增删改查，其中增删改也只有可变数组可以做，也就是说可变数组相对来说更加灵活，这几篇我们就说一下可变数组的这个类及其相关知识，还是老规矩从整体到局部，从浅入深进行讲解，谢谢大家。感兴趣的可以看我写的上面几篇。
1. NSMutableArray简单细说（一）—— 整体了解
2. NSMutableArray简单细说（二）—— 创建和初始化

一、- (void)addObject:(ObjectType)anObject;

该方法的作用是：在数组的末尾插入给定的对象。

下面看一下参数：

• anObject：将对象添加到数组的内容的末尾。 该值不能为零。如果anObject为零，则引发NSInvalidArgumentException异常。

看简单示例

- (void)demoAddObject
{
    NSMutableArray *arrM = [NSMutableArray array];
    [arrM addObject:@"hello"];
    NSLog(@"arrM = %@, count = %ld", arrM, arrM.count);
}

下面看输出结果

2017-08-26 20:18:41.376 JJOC[11456:294455] arrM = (
    hello
), count = 1

结论：可以加入非空对象。

二、- (void)addObjectsFromArray:(NSArray<ObjectType> *)otherArray;

该方法的作用：将包含在另一个给定数组中的对象添加到接收数组的内容的末尾。

下面看简单示例代码。

- (void)demoAddObjectsFromArray
{
    NSArray *givenArr = @[@1, @2, @3, @4];
    NSMutableArray *arrM = [NSMutableArray array];
    [arrM addObjectsFromArray:givenArr];
    NSLog(@"arrM = %@, count = %ld", arrM, arrM.count);
}

看输出结果

2017-08-26 20:23:42.816 JJOC[11648:299402] arrM = (
    1,
    2,
    3,
    4
), count = 4

结论：根据给定数组给可变数组增加元素。

三、- (void)insertObject:(ObjectType)anObject atIndex:(NSUInteger)index;

该方法的作用就是：在给定的索引中将给定对象插入到数组的内容中。

下面就看一下参数：

• anObject：要添加到数组的内容的对象。 该值不能为nil。如果anObject为nil，则引发NSInvalidArgumentException异常。
• index：要插入对象的数组中的索引。 该值不能大于数组中的元素数。如果索引大于数组中的元素数量，则引发NSRangeException。

下面还要注意：

• 如果索引已经被占用，索引和其他对象将通过向索引添加1来移动，以腾出空间。

请注意，NSArray对象不像C数组。 也就是说，即使您在创建数组时指定了大小，指定的大小也被视为“提示”; 数组的实际大小仍为0.这意味着您不能在大于当前数组的索引的索引上插入对象。 例如，如果数组包含两个对象，其大小为2，则可以在索引0,1或2处添加对象。索引3是非法的，超出范围; 如果您尝试在索引3添加一个对象（当数组的大小为2时），NSMutableArray引发异常。

下面看示例代码

- (void)demoInsertObject
{
    NSMutableArray *arrM = [NSMutableArray array];
    [arrM insertObject:@"hello, world" atIndex:0];
    NSLog(@"arrM = %@, count = %ld", arrM, arrM.count);
}

下面看输出结果

2017-08-26 20:32:45.194 JJOC[11930:309294] arrM = (
    "hello, world"
), count = 1

结论：数组中插入元素，可以随便的安排数组元素的位置。

四、- (void)insertObjects:(NSArray<ObjectType> *)objects atIndexes:(NSIndexSet *)indexes;

该方法的作用是：将提供的数组中的对象插入到指定索引的接收数组中。

下面看一下参数：

• objects：要插入到接收数组中的一组对象。
• indexes：要插入对象中的对象的索引。 索引中位置的计数必须等于对象的计数

还要注意：

• 对象中的每个对象依次在索引中指定的相应位置依次插入到接收数组中。 实现在概念上类似于以下示例中所示：

- void insertObjects:(NSArray *)additions atIndexes:(NSIndexSet *)indexes
{
    NSUInteger currentIndex = [indexes firstIndex];
    NSUInteger i, count = [indexes count];
 
    for (i = 0; i < count; i++)
    {
        [self insertObject:[additions objectAtIndex:i] atIndex:currentIndex];
        currentIndex = [indexes indexGreaterThanIndex:currentIndex];
    }
}

由以下示例说明产生的行为：

NSMutableArray *array = [NSMutableArray arrayWithObjects: @"one", @"two", @"three", @"four", nil];
NSArray *newAdditions = [NSArray arrayWithObjects: @"a", @"b", nil];
NSMutableIndexSet *indexes = [NSMutableIndexSet indexSetWithIndex:1];
[indexes addIndex:3];
[array insertObjects:newAdditions atIndexes:indexes];
NSLog(@"array: %@", array);
 
// Output: array: (one, a, two, b, three, four)

因此，如果一个位置指定阵列的计数或前面的插入之后的数组的计数，并且超出边界的其他位置以与该位置相邻的方式进行，则索引指定的位置可能只能超过接收阵列的范围， 如以下实施例所示。

在此示例中，两个新对象都附加到数组的末尾。

NSMutableArray *array = [NSMutableArray arrayWithObjects: @"one", @"two", @"three", @"four", nil];
NSArray *newAdditions = [NSArray arrayWithObjects: @"a", @"b", nil];
NSMutableIndexSet *indexes = [NSMutableIndexSet indexSetWithIndex:5];
[indexes addIndex:4];
[array insertObjects:newAdditions atIndexes:indexes];
NSLog(@"array: %@", array);
 
// Output: array: (one, two, three, four, a, b)

如果将[indexes addIndex：4]替换为[indexes addIndex：6]（使索引为5和6），则应用程序将失败并出现超出范围的异常。

在这个例子中，两个对象被添加到数组的中间，另一个在数组的当前端（索引4），这意味着它是从修改的数组的末尾开始的第三个。

NSMutableArray *array = [NSMutableArray arrayWithObjects: @"one", @"two", @"three", @"four", nil];
NSArray *newAdditions = [NSArray arrayWithObjects: @"a", @"b", @"c", nil];
NSMutableIndexSet *indexes = [NSMutableIndexSet indexSetWithIndex:1];
[indexes addIndex:2];
[indexes addIndex:4];
[array insertObjects:newAdditions atIndexes:indexes];
NSLog(@"array: %@", array);
 
// Output: array: (one, a, b, two, c, three, four)

如果用[indexes addIndex：6]替换[index addIndex：4]（使索引为1,2和6），则输出为（一，a，b，二，三，四，c）。

如果对象或索引为nil，此方法将引发异常。

下面看示例代码

- (void)demoInsertObjects
{
    NSMutableArray *array = [NSMutableArray arrayWithObjects: @"one", @"two", @"three", @"four", nil];
    NSArray *newAdditions = [NSArray arrayWithObjects: @"a", @"b", @"c", nil];
    NSMutableIndexSet *indexes = [NSMutableIndexSet indexSetWithIndex:1];
    [indexes addIndex:2];
    [indexes addIndex:4];
    [array insertObjects:newAdditions atIndexes:indexes];
    NSLog(@"array: %@", array);
}

下面看输出结果

2017-08-26 20:48:50.816 JJOC[12416:327044] array: (
    one,
    a,
    b,
    two,
    c,
    three,
    four
)

结论：集体插入对象，一劳永逸。

后记

未完，待续~~~