版本记录

前言

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

一、- (void)replaceObjectAtIndex:(NSUInteger)index withObject:(ObjectType)anObject;

该方法的作用就是：更换数组中的某一个对象。

下面看参数和返回值：

• index：要替换的对象的索引。 该值不能超过数组的边界。如果索引超出数组的末尾，则引发NSRangeException。
• anObject：用于替换数组中索引处的对象的对象。 该值不能为零。如果anObject为零，则引发NSInvalidArgumentException异常。

下面看示例代码

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

看输出结果

2017-08-26 22:18:50.039 JJOC[16183:420351] arrM = (
    10,
    2,
    3,
    4
), count = 4

结论：替换某个索引处的对象。

二、- (void)setObject:(ObjectType)obj atIndexedSubscript:(NSUInteger)idx;

该方法的作用就是：使用新对象替换索引处的对象，可能添加对象。

还要注意参数：

• obj：用于替换数组中索引索引处的对象的对象。 该值不能为零。如果anObject为零，则引发NSInvalidArgumentException异常。
• idx：要替换的对象的索引。 该值不能超过数组的边界。如果索引超出数组的末尾，则引发NSRangeException。

下面还要注意：

• 此方法与replaceObjectAtIndex：withObject：方法具有相同的行为。
• 如果index超出了数组的结尾（也就是说，如果index大于或等于count返回的值），则引发NSRangeException。
• 您不应该直接调用此方法。 而是使用下标通过索引设置对象时调用此方法。

mutableArray[3] = @"someValue"; 
// equivalent to [mutableArray replaceObjectAtIndex:3 withObject:@"someValue"]

结论：内部调用，不用自己主动调用方法。

三、- (void)replaceObjectsAtIndexes:(NSIndexSet *)indexes withObjects:(NSArray<ObjectType> *)objects;

该方法的作用就是：使用给定数组中的对象指定的位置替换接收数组中的对象。

下面看一下参数：

• indexes：要替换的对象的索引。
• objects：用于用索引指定的索引替换接收数组中的对象的对象。 索引中位置的计数必须等于对象的计数。

还要注意：

• 索引集中的索引以与对象中的对象相同的顺序使用。如果对象或索引为nil，则此方法会引发异常。

下面看简单示例

- (void)demoReplaceObjectsAtIndexes
{
    NSMutableArray *array = [NSMutableArray arrayWithObjects: @"one", @"a", @"two", @"b", @"three", @"four", nil];
    NSMutableIndexSet *indexes = [NSMutableIndexSet indexSetWithIndex:1];
    [indexes addIndex:3];
    NSArray *arr = @[@1, @3];
    [array replaceObjectsAtIndexes:indexes withObjects:arr];
    NSLog(@"array: %@", array);
}

下面看输出结果

2017-08-26 22:31:41.108 JJOC[16555:434840] array: (
    one,
    1,
    two,
    3,
    three,
    four
)

结论：批量替换很方便。

四、- (void)replaceObjectsInRange:(NSRange)range withObjectsFromArray:(NSArray<ObjectType> *)otherArray range:(NSRange)otherRange;

该方法的作用就是：将由一个给定范围指定的接收数组中的对象替换为由另一个范围指定的另一个数组中的对象。

下面看一下参数：

• range：要在接收数组（或从接收数组中删除）中替换的对象的范围。
• otherArray：要从中选择aRange中对象的替换的对象数组。
• otherRange：从otherArray中选择对象的范围作为aRange中对象的替换。

还要注意：

• aRange和otherRange的长度不必相等：如果aRange长于otherRange，则接收数组中的额外对象将被删除; 如果otherRange长于aRange，则来自otherArray的额外对象将插入到接收数组中。

看简单示例

- (void)demoReplaceObjectsInRange
{
    NSMutableArray *array1 = [NSMutableArray arrayWithObjects: @"one", @"two", @"three", @"Four", @"Five", nil];
    NSArray *arr = @[@1, @2, @3, @4, @5];
    [array1 replaceObjectsInRange:NSMakeRange(0, 3) withObjectsFromArray:arr range:NSMakeRange(0, 2)];
    NSLog(@"array1: %@", array1);
    
    NSMutableArray *array2 = [NSMutableArray arrayWithObjects: @"one", @"two", @"three", @"Four", @"Five", nil];
    NSArray *arr2 = @[@1, @2, @3, @4, @5];
    [array2 replaceObjectsInRange:NSMakeRange(0, 2) withObjectsFromArray:arr2 range:NSMakeRange(0, 3)];
    NSLog(@"array2: %@", array2);
}

看输出结果

2017-08-26 22:41:52.266 JJOC[16995:446163] array1: (
    1,
    2,
    Four,
    Five
)
2017-08-26 22:41:52.266 JJOC[16995:446163] array2: (
    1,
    2,
    3,
    three,
    Four,
    Five
)

结论：数组与数组之间指定区间元素互换。

五、- (void)replaceObjectsInRange:(NSRange)range withObjectsFromArray:(NSArray<ObjectType> *)otherArray;

该方法的作用就是：将给定范围指定的接收数组中的对象替换为给定数组中的所有对象。

还要注意：

• 如果otherArray的对象数量少于aRange所指定的数量，则接收数组中的额外对象将被删除。 如果otherArray具有比由aRange指定的对象更多的对象，则将来自otherArray的额外对象插入到接收数组中。

下面看示例代码

- (void)demoReplaceObjectsInRangeArray
{
    NSMutableArray *array1 = [NSMutableArray arrayWithObjects: @"one", @"two", @"three", @"Four", @"Five", nil];
    NSArray *arr = @[@1, @2, @3];
    [array1 replaceObjectsInRange:NSMakeRange(0, 2) withObjectsFromArray:arr];
    NSLog(@"array1: %@", array1);
    
    NSMutableArray *array2 = [NSMutableArray arrayWithObjects: @"one", @"two", @"three", @"Four", @"Five", nil];
    [array2 replaceObjectsInRange:NSMakeRange(0, 4) withObjectsFromArray:arr];
    NSLog(@"array2: %@", array2);
}

下面看示例代码

2017-08-26 22:59:36.943 JJOC[17314:458873] array1: (
    1,
    2,
    3,
    three,
    Four,
    Five
)
2017-08-26 22:59:36.943 JJOC[17314:458873] array2: (
    1,
    2,
    3,
    Five
)

结论：数组之间整体替换。

六、- (void)setArray:(NSArray<ObjectType> *)otherArray;

该方法的作用就是：将接收数组的元素设置为另一个给定数组中的元素。

看示例代码

- (void)demoSetArray
{
    NSMutableArray *arrM = [NSMutableArray array];
    NSArray *arr = @[@1, @2, @3];
    [arrM setArray:arr];
    NSLog(@"arrM: %@", arrM);
}

看输出结果

2017-08-26 23:16:11.583 JJOC[17588:467979] arrM: (
    1,
    2,
    3
)

结论：用数组初始化数组。

后记

未完，待续~~~