Retrieves the child element by attribute value.
CALL "C$XML" USING CXML-GET-CHILD-BY-ATTR-VALUE, handle, regex, flags
| CXML-GET-CHILD-BY-ATTR-VALUE | Op-code 19. 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-ATTR-VALUE | Value 19 |
| 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 operation retrieves the child element that has an attribute value that matches the regular expression given. Once you have the handle to the element of interest, you can call CXML-GET-DATA to retrieve the data associated with the element.