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 NODE-VALUE-TO-LONGCHAR( )
frees the memory currently allocated by 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.
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 longcharNODE-VALUE-TO-LONGCHAR( ) has
a size of zero length.
For more information on accessing XML documents using the Document Object
Model (DOM) interface, see Use XML with ABL Applications.
