Parses the specified string as XML
Syntax:
CALL "C$XML" USING CXML-PARSE-STRING, string
Parameters:
| CXML-PARSE-STRING
|
Op-code 11. Numeric data item that specifies the operation to perform. Each operation is defined in
acucobol.def, which is included with your system.
|
|
string
|
pic x(n) or alphanumeric literal
|
On Entry:
| CXML-PARSE-STRING
|
Value 11
|
|
string
|
The string or string reference to be parsed as XML
|
On Exit:
| RETURN-CODE
|
A parser handle
|
Example:
call "C$XML" using CXML-PARSE-STRING,
"<?xml version=""1.0""?><group1><subgroup1><item1>data</item1></subgroup1></group1>".
move return-code to parse-handle.
Comments:
This operation parses the specified string as XML, returning a parser handle. You can parse strings passed by reference. Note that strings passed by reference MUST be terminated with low-values so that the run-time can determine the length of the string passed. Not terminating with low-values will result in undefined behavior.
If you get XML text from another source and need to parse it, you can parse the string directly using the CXML-PARSE-STRING op-code. You do not have to write the data to a file, then parse the file. You simply specify the string directly in the call. See the example below.