Adds the values from one array to another array.
SDKs
- iOS 2.0+
- macOS 10.0+
- Mac Catalyst 13.0+
- tvOS 9.0+
- watchOS 2.0+
Framework
- Core Foundation
Declaration
void CFArrayAppendArray(CFMutable Array Ref theArray, CFArray Ref otherArray, CFRange otherRange);
Parameters
theArray
The array to which values from
other
are added. IfArray the
is a limited-capacity array, addingArray other
values fromRange .length other
must not cause the capacity limit ofArray the
to be exceeded.Array otherArray
An array providing the values to be added to
the
.Array otherRange
The range within
other
from which to add the values toArray the
. The range must not exceed the index space ofArray other
.Array
Discussion
The new values are retained by the
using the retain callback provided when the
was created. If the values are not of the type expected by the retain callback, the behavior is undefined. The values are assigned to the indices one larger than the previous largest index in the
, and beyond, and the count of the
is increased by other
. The values are assigned new indices in the
from smallest to largest index in the order in which they appear in other
.