isCOBOL Evolve : Appendices : Library Routines : C$XML : CXML-ADD-CHILD
CXML-ADD-CHILD
The CXML-ADD-CHILD function adds a child item to the given element.
Syntax:
 CALL "C$XML" USING CXML-ADD-CHILD
                    handle
                    elemName
                   [elemData]
                   [dataLength]
             GIVING childHandle
Parameters:
CXML-ADD-CHILD
Constant
 
handle
USAGE HANDLE
A XML element handle.
elemName
PIC X(n)
Specifies the name of the child element that you’re going to add.
elemData
PIC X(n)
Specifies the value of the new child element. If omitted, blank is used.
attrLength
PIC 9(n)
Specifies the length of the element value. If omitted, it defaults to the length of elemData.
Return code:
childHandle must be a USAGE HANDLE data item. It receives the handle of the new child element. It’s good practice to free this handle with a DESTROY statement before reusing it in order to avoid memory leaks.