4D v12.4
DOM EXPORT TO VAR
- 4D Language Reference
-
- XML DOM
-
- Overview of XML DOM Commands
- DOM Append XML child nodeNew
- DOM Append XML elementNew
- DOM CLOSE XML
- DOM Count XML attributes
- DOM Count XML elements
- DOM Create XML element
- DOM Create XML element arraysNew
- DOM Create XML Ref
- DOM EXPORT TO FILE
- DOM EXPORT TO VAR
- DOM Find XML element
- DOM Find XML element by ID
- DOM Get first child XML element
- DOM Get last child XML element
- DOM Get next sibling XML element
- DOM Get parent XML element
- DOM Get previous sibling XML element
- DOM Get Root XML element
- DOM GET XML ATTRIBUTE BY INDEX
- DOM GET XML ATTRIBUTE BY NAME
- DOM GET XML CHILD NODESNew
- DOM Get XML document refNew
- DOM Get XML element
- DOM GET XML ELEMENT NAME
- DOM GET XML ELEMENT VALUEUpd
- DOM Get XML information
- DOM Insert XML elementNew
- DOM Parse XML source
- DOM Parse XML variable
- DOM REMOVE XML ATTRIBUTENew
- DOM REMOVE XML ELEMENT
- DOM SET XML ATTRIBUTE
- DOM SET XML DECLARATIONUpd
- DOM SET XML ELEMENT NAME
- DOM SET XML ELEMENT VALUE
DOM EXPORT TO VAR
| DOM EXPORT TO VAR ( elementRef ; vXmlVar ) | ||||||||
| Parameter | Type | Description | ||||||
| elementRef | String |
|
Root XML element reference | |||||
| vXmlVar | Text, BLOB |
|
Variable to receive XML tree | |||||
The DOM EXPORT TO VAR command saves an XML tree in a text or BLOB variable.
Pass the root element reference to export in elementRef.
Pass the name of the variable that must contain the XML tree in vXmlVar. This variable must either be a Text or BLOB type. You can select the type depending on what you plan on doing next or the size that the tree can reach (remember that when not in Unicode mode, Text type variables are limited to 32 K of text, whereas in Unicode mode, this limit is 2 GB).
Keep in mind that if you use a Text variable to store elementRef when not in Unicode mode, , it will be encoded using the “current” Mac character set (i.e. Mac Roman on most Western systems). This means that the text returned will lose its original encoding (encoding="xxx"). In this case, the vVarXml variable allows you to view or store the code but NOT to generate a valid XML document (using the SEND PACKET command for example).
In Unicode mode, the original encoding is kept in the variable.
This example stores the tree vElemRef in a text variable:
C_TEXT(vtMyText)
DOM EXPORT TO VAR(vElemRef;vtMyText)If the command has been executed correctly, the system variable OK is set to 1. Otherwise, it is set to 0 and an error is generated (for example, if the element reference is invalid).
Product: 4D
Theme: XML DOM
Number:
863
Created: 4D 2004
DOM EXPORT TO FILE
SVG EXPORT TO PICTURE
