xml.DomDocument.setXmlStandalone

Sets the XML standalone attribute in the XML declaration to "yes" or "no" in the XML declaration, or removes the standalone attribute.

Syntax

setXmlStandalone(
   alone INTEGER )
  1. alone defines a boolean flag.
    • 1 sets the standalone attribute to "yes".
    • 0 sets the standalone attribute to "no".
    • -1 removes the standalone attribute.

Usage

This sample sets the standalone attribute to "no":
IMPORT XML

MAIN
  DEFINE doc xml.DomDocument

  LET doc = xml.DomDocument.Create()
  CALL doc.setXmlStandalone(0)

  DISPLAY doc.saveToString()
END MAIN
The output displayed by the above example is <?xml version="1.0" encoding="UTF-8" standalone="no"?>.
This sample sets the standalone attribute to "yes":
IMPORT XML

MAIN
  DEFINE doc xml.DomDocument

  LET doc = xml.DomDocument.Create()
  CALL doc.setXmlStandalone(1)

  DISPLAY doc.saveToString()
END MAIN
The output displayed by the above example is <?xml version="1.0" encoding="UTF-8" standalone="yes"?>.
This sample removes the standalone attribute:
IMPORT XML

MAIN
  DEFINE doc xml.DomDocument

  LET doc = xml.DomDocument.Create()
  CALL doc.setXmlStandalone(-1)

  DISPLAY doc.saveToString()
END MAIN
The output displayed by the above example is <?xml version="1.0" encoding="UTF-8"?>.

In case of error, the method throws an exception and sets the STATUS variable. Depending on the error, a human-readable description of the problem is available in the SQLCA.SQLERRM register. See Error handling in GWS calls (STATUS).