Instance Method

initWithObjects:count:

Initializes a newly allocated array to include a given number of objects from a given C array.

Declaration

- (instancetype)initWithObjects:(ObjectType  _Nonnull const *)objects count:(NSUInteger)cnt;

Parameters

objects

A C array of objects.

count

The number of values from the objects C array to include in the new array. This number will be the count of the new array—it must not be negative or greater than the number of elements in objects.

Return Value

A newly allocated array including the first count objects from objects. The returned object might be different than the original receiver.

Discussion

Elements are added to the new array in the same order they appear in objects, up to but not including index count.

After an immutable array has been initialized in this way, it can’t be modified.

This method is a designated initializer.

See Also

Initializing an Array

init

Initializes a newly allocated array.

initWithArray:

Initializes a newly allocated array by placing in it the objects contained in a given array.

initWithArray:copyItems:

Initializes a newly allocated array using anArray as the source of data objects for the array.

initWithContentsOfFile:

Initializes a newly allocated array with the contents of the file specified by a given path.

Deprecated
initWithContentsOfURL:

Initializes a newly allocated array with the contents of the location specified by a given URL.

Deprecated
initWithObjects:

Initializes a newly allocated array by placing in it the objects in the argument list.