xml.DomDocument.loadFromPipe

Loads a XML Document into a DomDocument object from a PIPE.

Syntax

loadFromPipe(
   name STRING )
  1. name defines the command to read from the PIPE.

Usage

Use this method to load a XML Document into a DomDocument object from a PIPE, where name is the command to read from the PIPE.

Important: This method is not part of W3C standard API.

Use setFeature() to specify how the document can be loaded. HTML parsing is possible when enable-html-compliancy is enabled.

See getErrorsCount() and getErrorDescription() to retrieve error messages related to XML document.

Note: When loading a document, if xml.DomNode objects are still referenced in other variables of the program, the entire document is kept in memory. Otherwise, the DOM nodes of the document are deleted before loading the new document. For more details about object references and garbage collection in BDL, see Working with objects.

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).