---
title: "CFArrayCreateMutableCopy(_:_:_:)"
framework: corefoundation
role: symbol
role_heading: Function
path: "corefoundation/cfarraycreatemutablecopy(_:_:_:)"
---

# CFArrayCreateMutableCopy(_:_:_:)

Creates a new mutable array with the values from another array.

## Declaration

```swift
func CFArrayCreateMutableCopy(_ allocator: CFAllocator!, _ capacity: CFIndex, _ theArray: CFArray!) -> CFMutableArray!
```

## Parameters

- `allocator`: The allocator to use to allocate memory for the new array and its storage for values. Pass NULL or doc://com.apple.corefoundation/documentation/CoreFoundation/kCFAllocatorDefault to use the current default allocator.
- `capacity`: The maximum number of values that can be contained by the new array. The array starts with the same number of values as theArray and can grow to this number of values (and it can have less). Pass 0 to specify that the maximum capacity is not limited. If non-0, capacity must be greater than or equal to the count of theArray.
- `theArray`: The array to copy. The pointer values from the array are copied into the new array. However, the values are also retained by the new array.

## Return Value

Return Value A new mutable array that contains the same values as theArray. The new array has the same count as the theArray and uses the same callbacks. Ownership follows the The Create Rule.

## See Also

### CFMutableArray Miscellaneous Functions

- [CFArrayAppendArray(_:_:_:)](corefoundation/cfarrayappendarray(_:_:_:).md)
- [CFArrayAppendValue(_:_:)](corefoundation/cfarrayappendvalue(_:_:).md)
- [CFArrayCreateMutable(_:_:_:)](corefoundation/cfarraycreatemutable(_:_:_:).md)
- [CFArrayExchangeValuesAtIndices(_:_:_:)](corefoundation/cfarrayexchangevaluesatindices(_:_:_:).md)
- [CFArrayInsertValueAtIndex(_:_:_:)](corefoundation/cfarrayinsertvalueatindex(_:_:_:).md)
- [CFArrayRemoveAllValues(_:)](corefoundation/cfarrayremoveallvalues(_:).md)
- [CFArrayRemoveValueAtIndex(_:_:)](corefoundation/cfarrayremovevalueatindex(_:_:).md)
- [CFArrayReplaceValues(_:_:_:_:)](corefoundation/cfarrayreplacevalues(_:_:_:_:).md)
- [CFArraySetValueAtIndex(_:_:_:)](corefoundation/cfarraysetvalueatindex(_:_:_:).md)
- [CFArraySortValues(_:_:_:_:)](corefoundation/cfarraysortvalues(_:_:_:_:).md)