Function

CFPropertyListCreateWithData

Creates a property list from a given CFData object.

Declaration

CFPropertyListRef CFPropertyListCreateWithData(CFAllocatorRef allocator, CFDataRef data, CFOptionFlags options, CFPropertyListFormat *format, CFErrorRef *error);

Parameters

allocator

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

data

A CFData object containing a serialized representation of a property list.

options

A CFPropertyListMutabilityOptions constant to specify the mutability of the returned property list—see Property List Mutability Options for possible values.

format

If this parameter is non-NULL, on return it will be set to the format of the data. See CFPropertyListFormat for possible values.

error

If this parameter is non-NULL, if an error occurs, on return this will contain a CFError error describing the problem. Ownership follows the The Create Rule.

Return Value

A new property list created from the data in data. If an error occurs while parsing the data, returns NULL. Ownership follows the The Create Rule.

See Also

Creating a Property List

CFPropertyListCreateWithStream

Create and return a property list with a CFReadStream input.

CFPropertyListCreateDeepCopy

Recursively creates a copy of a given property list.

CFPropertyListCreateFromXMLData

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

Deprecated
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