Instance Method

removeObjectsAtIndexes:

Removes the objects at the specified indexes from the array.

Declaration

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

Parameters

indexes

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

Discussion

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.

Deprecated
- 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.