Creates a string from a buffer of Unicode characters that might serve as the backing store for the 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
kto use the current default allocator.
The Unicode buffer that has been allocated and initialized with Unicode characters.
The number of characters in the buffer pointed to by
chars. Only this number of characters will be copied to internal storage.
The allocator to use to deallocate the external buffer when it is no longer needed. You can pass
kto request the default allocator for this purpose. If the buffer does not need to be deallocated, or if you want to assume responsibility for deallocating the buffer (and not have the string deallocate it), pass
An immutable string containing
NULL if there was a problem creating the object. Ownership follows the The Create Rule.
Unless the situation warrants otherwise, the returned object does not copy the external buffer to internal storage but instead uses the buffer as its backing store. However, you should never count on the object using the external buffer since it could copy the buffer to internal storage or might even dump the buffer altogether and use alternative means for storing the characters.
The function includes a
contents parameter with which to specify an allocator to use for deallocating the external buffer when the string is deallocated. If you want to assume responsibility for deallocating this memory, specify
k for this parameter.
If at creation time CFString decides it can't use the buffer, and there is a
contents, it will use this allocator to free the buffer at that time.
If an error occurs during the creation of the string, then
chars is not deallocated. In this case, the caller is responsible for freeing the buffer. This allows the caller to continue trying to create a string with the buffer, without having the buffer deallocated.