Instance Method

containsObject:

Returns a Boolean value that indicates whether a given object is present in the array.

Declaration

- (BOOL)containsObject:(ObjectType)anObject;

Parameters

anObject

An object to look for in the array.

Return Value

YES if anObject is present in the array, otherwise NO.

Discussion

Starting at index 0, each element of the array is checked for equality with anObject until a match is found or the end of the array is reached. Objects are considered equal if isEqual: returns YES.

To determine if the array contains a particular instance of an object, you can test for identity rather than equality by calling the indexOfObjectIdenticalTo: method and comparing the return value to NSNotFound.

See Also

Querying an Array

count

The number of objects in the array.

- getObjects:

Copies all the objects contained in the array to aBuffer.

Deprecated
- getObjects:range:

Copies the objects contained in the array that fall within the specified range to aBuffer.

firstObject

The first object in the array.

lastObject

The last object in the array.

- objectAtIndex:

Returns the object located at the specified index.

- objectAtIndexedSubscript:

Returns the object at the specified index.

- objectsAtIndexes:

Returns an array containing the objects in the array at the indexes specified by a given index set.

- objectEnumerator

Returns an enumerator object that lets you access each object in the array.

- reverseObjectEnumerator

Returns an enumerator object that lets you access each object in the array, in reverse order.

Beta Software

This documentation contains preliminary information about an API or technology in development. This information is subject to change, and software implemented according to this documentation should be tested with final operating system software.

Learn more about using Apple's beta software