Function

CFXMLTreeCreateFromDataWithError

Parses the given XML data and returns the resulting CFXMLTree object and any error information.

Declaration

CFXMLTreeRef CFXMLTreeCreateFromDataWithError(CFAllocatorRef allocator, CFDataRef xmlData, CFURLRef dataSource, CFOptionFlags parseOptions, CFIndex versionOfNodes, CFDictionaryRef *errorDict);

Parameters

allocator

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

xmlData

The XML data you wish to parse.

dataSource

The URL from which the XML data was obtained. The URL is used to resolve any relative references found in xmlData. Pass NULL if a valid URL is unavailable.

parseOptions

Flags which control how the XML data will be parsed. See CFXMLParserOptions for the list of available options.

versionOfNodes

Determines which version of CFXMLNode objects are produced by the parser. The current version is 1.

errorDict

Upon return, if an error occurs contains a CFDictionary object that describes the error. If no errors occur, this parameter is not changed. Pass NULL if you don’t want error information. See Error Dictionary Keys for a description of the key-value pairs in this dictionary. Ownership follows the The Create Rule.

Return Value

A new CFXMLTree object containing the data from the specified XML document. Ownership follows the The Create Rule.

Discussion

Use this function instead of CFXMLTreeCreateFromData if you need access to XML parsing errors.

See Also

CFXMLTree Miscellaneous Functions

CFXMLCreateStringByEscapingEntities

Given a CFString object containing XML source with unescaped entities, returns a string with specified XML entities escaped.

CFXMLCreateStringByUnescapingEntities

Given a CFString object containing XML source with escaped entities, returns a string with specified XML entities unescaped.

CFXMLTreeCreateFromData

Parses the given XML data and returns the resulting CFXMLTree object.

Deprecated
CFXMLTreeCreateWithDataFromURL

Creates a new CFXMLTree object by loading the data to be parsed directly from a data source.

Deprecated
CFXMLTreeCreateWithNode

Creates a childless, parentless CFXMLTree object node for a CFXMLNode object.

Deprecated
CFXMLTreeCreateXMLData

Generates an XML document from a CFXMLTree object which is ready to be written to permanent storage.

Deprecated
CFXMLTreeGetNode

Returns the node of a CFXMLTree object.

Deprecated