NODE-VALUE-TO-LONGCHAR( ) method

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.