GParser Interface

Table 18-3 summarizes the methods of available through the GParser interface.

SetWarnDuplicateEntity

Specifies if entities that are declared more than once will cause warnings to be issued.

void setWarnDuplicateEntity(
   boolean par_bool);

par_bool

getBaseURI

Returns the base URI for the document. Usually only documents loaded from a URI will automatically have a base URI. Documents loaded from other sources (stdin, buffer, and so on) will not naturally have a base URI, but a base URI may have been set for them using setBaseURI, for the purposes of resolving relative URIs in inclusion.

oratext* getBaseURI() const;

(oratext *) current document's base URI [or NULL]

getDiscardWhitespaces

Checks if formatting whitespaces between elements, such as newlines and indentation in input documents are discarded. By default, all input characters are preserved.

boolean getDiscardWhitespaces() const;

(boolean) TRUE if whitespace between elements are discarded

getExpandCharRefs

Checks if character references are expanded in the DOM data. By default, character references are replaced by the character they represent. However, when a document is saved those characters entities do not reappear. To ensure they remain through load and save, they should not be expanded.

boolean getExpandCharRefs() const;

(boolean) TRUE if character references are expanded

getSchemaLocation

Gets schema location for this document. It is used to figure out the optimal layout when loading documents into a database.

oratext* getSchemaLocation() const;

(oratext*) schema location

getStopOnWarning

When TRUE is returned, warnings are treated the same as errors and cause parsing, validation, and so on, to stop immediately. By default, warnings are issued but the processing continues.

boolean getStopOnWarning() const;

(boolean) TRUE if document processing stops on warnings

getWarnDuplicateEntity

Get if entities which are declared more than once will cause warnings to be issued.

boolean getWarnDuplicateEntity() const;

(boolean) TRUE if multiple entity declarations cause a warning

setBaseURI

Sets the base URI for the document. Usually only documents that were loaded from a URI will automatically have a base URI. Documents loaded from other sources (stdin, buffer, and so on) will not naturally have a base URI, but a base URI may have been set for them using setBaseURI, for the purposes of resolving relative URIs in inclusion.

void setBaseURI( oratext* par);

par

setDiscardWhitespaces

Sets if formatting whitespaces between elements (newlines and indentation) in input documents are discarded. By default, ALL input characters are preserved.

void setDiscardWhitespaces(
   boolean par_bool);

par_bool

setExpandCharRefs

Sets if character references should be expanded in the DOM data. Ordinarily, character references are replaced by the character they represent. However, when a document is saved those characters entities do not reappear. To ensure they remain through load and save is to not expand them.

void setExpandCharRefs( 
   boolean par_bool);

par_bool

setSchemaLocation

Sets schema location for this document. It is used to figure out the optimal layout when loading documents into a database.

void setSchemaLocation(
   oratext* par);

par

setStopOnWarning

When TRUE is set, warnings are treated the same as errors and cause parsing, validation, and so on, to stop immediately. By default, warnings are issued but the processing continues.

void setStopOnWarning( 
   boolean par_bool);

par_bool