xmlengxestd.h File Reference

XmlEngLeaveL ( TInt )

IMPORT_C voidXmlEngLeaveL(TIntaCode)
Leaves with the specified error code.
Parameters
aCodeLeave code
Leave Codes

XmlEnginePushL ( )

IMPORT_C voidXmlEnginePushL()

Initializes the global data required for libxml2 and pushes a cleanup item for XML Engine internal data to the CleanupStack.

This function should be used before any use of the DOM Parser or RXmlEngDocument::SaveL() method.

This function should have matching call to XmlEnginePopAndClose().

See also: XmlEnginePopAndClose XmlEngineCleanup XmlEngineAttachL

Leave Codes
KErrNoMemoryMemory allocation error

XmlEnginePopAndClose ( )

IMPORT_C voidXmlEnginePopAndClose()

Removes a cleanup item for XML Engine internal data from the CLeanupStack and frees any memory allocated by XML Engine's internals

See also: XmlEnginePushL

XmlEngineAttachL ( )

IMPORT_C voidXmlEngineAttachL()

Adds a user of Xml Engine and gets or initializes the global data required for libxml2. It does NOT put a cleanup item on the CleanupStack.

A "user" here is any processing entity that will use XML Engine's API (SAX, DOM, XPath, etc)). If several instances of XML parser are used within one thread, then XmlEngineAttach() should be called for each of them.

Every call to this method should be matched with a call to XmlEngineCleanup().

See also: XmlEngineCleanup XmlEnginePushL

XmlEngineCleanup ( TAny * )

IMPORT_C voidXmlEngineCleanup(TAny *aParserContext = NULL)

Cleans up resources internally allocated by XML parser and (optionally) frees a parser context provided as an argument. Does NOT pop a cleanup item off the CleanupStack

This function is to be used as a TCleanupItem on the CleanupStack and may be invoked directly.

Libxml2 uses the Symbian implementation of POSIX standard libraries. During closure of XmlEngine library, the standard library is also closed by default.User can choose not to close the standard library when XmlEngine shuts down, by using overloaded XmlEngineCleanup(TBool) method instead.

See also: XmlEngineAttachL XmlEnginePopAndClose

Parameters
aParserContextA pointer to xmlParserCtxt