CXML-GET-PREV-SIBLING

Retrieves the previous sibling element of the handle passed.

Syntax:

CALL "C$XML" USING CXML-GET-PREV-SIBLING, handle

Parameters:

CXML-GET-PREV-SIBLING Op-code 13. 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

On Entry:

CXML-GET-PREV-SIBLING Value 13
handle An element handle

On Exit:

RETURN-CODE

A handle of the previous sibling element, or 0 if no previous siblings. (The case of no previous sibling is not considered an error, even though CXML-GET-LAST-ERROR will return 11.

Comments:

Once a file has been opened and parsed, you must move to an element of interest before you can retrieve its data. This op-code provides a method of moving backwards in an XML file.