This method allows the application to define which XML elements should not have unnecessary white space stripped away from around the node.
This method will override any values set by the stripSpace() method. This way if stripSpace('*') is called, then this method can be called to define exceptions, for example, preserveSpace('cost'). In this example, all nodes except the 'cost' node will have all unnecessary white space stripped around it. This method can be called multiple times, once for each element.
The pElementName should not have a namespace prefix. Instead, to indicate a namespace for the element pass in the namespace URI for the element via the pNamespaceURI parameter. A combination of namespace URI and an element name of "*" is valid and specifies all elements in that namespace.
- Parameters
-
pElementName | [ in ] String name of an XML element not to strip unecessary white space around. |
elemLength | [ in ] length of characters in pElementName. |
pNamespaceURI | [ in ] can be NULL, URI of an associated namespace for the element |
uriLength | [ in ] length of characters in pNamespaceURI |
- Returns
Success | P6R::eOk | |
Failure | P6R::eNotInitialized | A successful call to intialize() must be made before calling this funciton. |
P6R::eInvalidArg | pElementName is NULL or length is zero. |