Retrieves the named child element.
CALL "C$XML" USING CXML-GET-CHILD-BY-NAME, handle, regex, flags
| CXML-GET-CHILD-BY-NAME | Op-code 16. Numeric data item that specifies the operation to perform. Each operation is defined in acucobol.def, which is included with your system. |
| handle | USAGE handle |
| regex | A regular expression |
|
flags
(Optional) |
Numeric value |
| CXML-GET-CHILD-BY-NAME | Value 16 |
| handle | An element handle |
|
flags
(Optional) |
A collection of flags to apply to the regular expression. The valid flags are listed in acucobol.def and described under C$REGEXP op-code 2. They can be added together to get more than one flag. |
| RETURN-CODE |
The handle of the returned child, or 0 if no such child exists. |
Comments:
This option allows you to navigate to a specific child rather than simply the next or previous one. Note that this op-code does not retrieve element data, but moves to the element and returns the element handle. Once you have the handle to the element of interest, you can call CXML-GET-DATA to retrieve the data associated with the element.