isCOBOL Evolve : Appendices : Internal Objects : XMLStream Class (com.iscobol.rts.XMLStream) : read
read
Reads an XML stream or file and puts its content in the data item associated with the XMLStream object.
Format 1
void read ( Xml-Source )
Format 2
void read ( Xml-Source, encoding )
Syntax rules
1. Xml-Source can be either a Data Item or a Nonnumeric Literal.
2. encoding is a string literal or data item that specifies the character set to be used while parsing the JSON stream. It accepts the same values as the iscobol.encoding * configuration property.
General rules
1. Xml-Source refers to a regular disk file.
2. When the read method is invoked, the whole content of Xml-Source is read and the data item associated with the XMLStream object is updated.
 
NOTE - If the number of occurrences of an XML field is not known at the time the program is written, specifying the DYNAMIC phrase of the OCCURS clause in the data item associated with the XMLStream object is recommended.
Code example
...
configuration section.
repository. 
    class xmlStream  as "com.iscobol.rts.XMLStream"
    .
...
working-storage section.
...
77 objXmlStream object reference xmlStream.
...
procedure division.
...
objXmlStream:>read("Sample.xml")
...