Instance Method

indexOfObject:inRange:

Returns the lowest index within a specified range whose corresponding array value is equal to a given object .

Declaration

- (NSUInteger)indexOfObject:(ObjectType)anObject inRange:(NSRange)range;

Parameters

anObject

An object.

range

The range of indexes in the array within which to search for anObject.

Return Value

The lowest index within range whose corresponding array value is equal to anObject. If none of the objects within range is equal to anObject, returns NSNotFound.

Discussion

Starting at range.location, each element of the array is passed as an argument to an isEqual: message sent to anObject until a match is found or the end of the range is reached. Objects are considered equal if isEqual: returns YES.

This method raises an NSRangeException exception if the range parameter represents a range that doesn’t exist in the array.

See Also

Finding Objects in an Array

- indexOfObject:

Returns the lowest index whose corresponding array value is equal to a given object.

- indexOfObjectIdenticalTo:

Returns the lowest index whose corresponding array value is identical to a given object.

- indexOfObjectIdenticalTo:inRange:

Returns the lowest index within a specified range whose corresponding array value is equal to a given object .

- indexOfObjectPassingTest:

Returns the index of the first object in the array that passes a test in a given block.

- indexOfObjectWithOptions:passingTest:

Returns the index of an object in the array that passes a test in a given block for a given set of enumeration options.

- indexOfObjectAtIndexes:options:passingTest:

Returns the index, from a given set of indexes, of the first object in the array that passes a test in a given block for a given set of enumeration options.

- indexesOfObjectsPassingTest:

Returns the indexes of objects in the array that pass a test in a given block.

- indexesOfObjectsWithOptions:passingTest:

Returns the indexes of objects in the array that pass a test in a given block for a given set of enumeration options.

- indexesOfObjectsAtIndexes:options:passingTest:

Returns the indexes, from a given set of indexes, of objects in the array that pass a test in a given block for a given set of enumeration options.

- indexOfObject:inSortedRange:options:usingComparator:

Returns the index, within a specified range, of an object compared with elements in the array using a given NSComparator block.