parseString

parseString(str:     String
            isFinal: ParamListType);

The parseString method of the JadeXMLParser class parses the XML document string (or the next part of the document string) specified in the str parameter. The optional isFinal parameter is a Boolean parameter (which is true by default) that informs the parser that this is the last piece of the document. The following example shows the use of the parseString method.

vars
    parser : MyDocXMLParser;
begin
    create parser transient;
    assertFalse(parser.foundEntity);
    parser.parseString('<DocEg></DocEg>', true);
    assertTrue(parser.foundEntity);
    assertEquals("Doc", parser.entityValue);
epilog
    delete parser;
end;

This method is synchronous, and it will not return until parsing has ended. An application in which you may require early termination of parsing should raise an exception.

As applications cannot invoke this method while a parse operation is in progress, create a new JadeXMLParser object instead for each nested XML document. When a parse is complete, the application can reuse the same JadeXMLParser object.

During the parse operation, the JADE Parser provides information about the XML document through the implemented callback methods.