Contents

CFXMLTreeCreateFromDataWithError

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

Declaration

extern 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 20001148 103029.

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