Copies the contents of an XML X-noderef node
to a LONGCHAR, and optionally converts the contents to a specific
code page.
Return type: LOGICAL
Applies to:
X-noderef object handle
Syntax
NODE-VALUE-TO-LONGCHAR ( longchar [codepage ] )
|
-
longchar
- An expression of type LONGCHAR.
-
codepage
- A character-string expression that evaluates to the name of
a code page. The name you specify must be a valid code page name
available in the DLC/convmap.cp file. If you
do not specify codepage and the code page of longchar is
fixed (that is, set using the FIX-CODEPAGE statement), the AVM converts longchar to the
fixed code page. If you do not specify codepage and
the code page of longchar is not fixed, the AVM
converts longchar to the code page specified by -cpinternal.
If you specify codepage and the code page of longchar is fixed,
they must agree. Otherwise, the AVM raises a run-time error.
NODE-VALUE-TO-LONGCHAR( )
frees the memory currently allocated by longchar (if
any), allocates sufficient memory to the LONGCHAR to accommodate
the node, and copies the node to the LONGCHAR.
If X-NODEREF:NODE-VALUE
is the empty string (""), the resulting longchar has
a size of zero length.
For more information on accessing XML
documents using the Document Object Model (DOM) interface, see OpenEdge®
Development: Working with XML.