Creates a string from its “external representation.”
SDKs
- iOS 2.0+
- macOS 10.0+
- Mac Catalyst 13.0+
- tvOS 9.0+
- watchOS 2.0+
Framework
- Core Foundation
Declaration
CFString Ref CFStringCreateFromExternalRepresentation(CFAllocator Ref alloc, CFData Ref data, CFString Encoding encoding);
Parameters
alloc
The allocator to use to allocate memory for the new string. Pass
NULL
ork
to use the current default allocator.CFAllocator Default data
The CFData object containing bytes that hold the characters in the specified encoding.
encoding
The encoding to use when interpreting the bytes in the data argument.
Return Value
An immutable string containing the characters from data
, or NULL
if there was a problem creating the object. Ownership follows the The Create Rule.
Discussion
In the CFData object form, the string can be written to disk as a file or be sent out over a network. If the encoding of the characters in the data object is Unicode, the function reads any BOM (byte order marker) and properly resolves endianness.
The CFString
function complements this function by creating an “external representation” CFData object from a string.