CFPropertyListCreateFromXMLData

Header: CFPropertyList.h Carbon status: Supported

Creates a property list using the specified XML data.

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

The allocator to use. Pass NULL to use the default allocator.

xmlData

The XML that you wish to convert into a property list.

mutabilityOption

A constant specifying the degree of mutability for the plist. See Property List Mutability Flags for descriptions of possible values.

errorString

On return, if the conversion is successful, this will be NULL. If the conversion fails, a string is returned to you describing the nature of the error. If an error string is returned, you must release it.

function result

A reference to one of the Core Foundataion property list types, depending on the contents of the XML data. Most often a CFArray or CFDictionary, NULL if there was an error.

AVAILABILITY

Supported in Carbon. Available in Carbon 1.0.2 and later.


© 2000 Apple Computer, Inc. (Last Updated 6/30/2000)