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