Instance Method


Removes the objects at the specified indexes from the array.


- (void)removeObjectsAtIndexes:(NSIndexSet *)indexes;



The indexes of the objects to remove from the array. The locations specified by indexes must lie within the bounds of the array.


This method is similar to removeObjectAtIndex:, but allows you to efficiently remove multiple objects with a single operation. indexes specifies the locations of objects to be removed given the state of the array when the method is invoked, as illustrated in the following example:

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

If indexes is nil, this method raises an exception.

See Also

Removing Objects

- removeAllObjects

Empties the array of all its elements.

- removeLastObject

Removes the object with the highest-valued index in the array

- removeObject:

Removes all occurrences in the array of a given object.

- removeObject:inRange:

Removes all occurrences within a specified range in the array of a given object.

- removeObjectAtIndex:

Removes the object at index .

- removeObjectIdenticalTo:

Removes all occurrences of a given object in the array.

- removeObjectIdenticalTo:inRange:

Removes all occurrences of anObject within the specified range in the array.

- removeObjectsFromIndices:numIndices:

Removes the specified number of objects from the array, beginning at the specified index.

- removeObjectsInArray:

Removes from the receiving array the objects in another given array.

- removeObjectsInRange:

Removes from the array each of the objects within a given range.