Creates an empty CFMutableString object.
- iOS 2.0+
- macOS 10.0+
- Mac Catalyst 13.0+
- tvOS 9.0+
- watchOS 2.0+
- Core Foundation
The allocator to use to allocate memory for the new string. Pass
NULLor kCFAllocatorDefault to use the current default allocator.
The maximum number of Unicode characters that can be stored by the returned string. Pass
0if there should be no character limit. Note that initially the string still has a length of
0; this parameter simply specifies what the maximum size is. CFMutableString might try to optimize its internal storage by paying attention to this value.
A new empty CFMutableString object or
NULL if there was a problem creating the object. Ownership follows the The Create Rule.
This function creates an empty (that is, content-less) CFMutableString object. You can add character data to this object with any of the
CFString functions, and thereafter you can insert, delete, replace, pad, and trim characters with the appropriate CFString functions. If the
max parameter is greater than
0, any attempt to add characters beyond this limit results in a run-time error.