Function

CFPropertyListCreateFromXMLData

Creates a property list using the specified XML or binary property list data.

Declaration

CFPropertyListRef CFPropertyListCreateFromXMLData(CFAllocatorRef allocator, CFDataRef xmlData, CFOptionFlags mutabilityOption, CFStringRef *errorString);

Parameters

allocator

The allocator to use to allocate memory for the new property list. Pass NULL or kCFAllocatorDefault to use the current default allocator.

data

The raw bytes to convert into a property list. The bytes may be the content of an XML file or of a binary property list (see CFPropertyListFormat).

mutabilityOption

A constant that specifies the degree of mutability for the returned property list. See Property List Mutability Options for descriptions of possible values.

errorString

On return, NULL if the conversion is successful, otherwise a string that describes the nature of the error. Error messages are not localized, but may be in the future, so they are not currently suitable for comparison.

Pass NULL if you do not wish to receive an error string. Ownership follows the The Create Rule.

Return Value

A new property list if the conversion is successful, otherwise NULL. Ownership follows the The Create Rule.

Discussion

See Also

Creating a Property List

CFPropertyListCreateWithData

Creates a property list from a given CFData object.

CFPropertyListCreateWithStream

Create and return a property list with a CFReadStream input.

CFPropertyListCreateDeepCopy

Recursively creates a copy of a given property list.

CFPropertyListCreateFromStream

Creates a property list using data from a stream.

Deprecated

Beta Software

This documentation contains preliminary information about an API or technology in development. This information is subject to change, and software implemented according to this documentation should be tested with final operating system software.

Learn more about using Apple's beta software