public abstract Class XMLScanner

Checks whether this string would be unchanged by normalization.

Returns:int

-1 if the value would be unchanged by normalization, otherwise the index of the first whitespace character which would be transformed.

Normalize whitespace in an XMLString converting all whitespace characters to space characters.

Normalize whitespace in an XMLString converting all whitespace characters to space characters.

Convenience function used in all XML scanners.

Scans an attribute value and normalizes whitespace converting all whitespace characters to space characters. [10] AttValue ::= '"' ([^<&"] | Reference)* '"' | "'" ([^<&'] | Reference)* "'"

Parameters

value:XMLString

The XMLString to fill in with the value.

nonNormalizedValue:XMLString

The XMLString to fill in with the non-normalized value.

atName:String

The name of the attribute being parsed (for error msgs).

checkEntities:boolean

true if undeclared entities should be reported as VC violation, false if undeclared entities should be reported as WFC violation.

eleName:String

The name of element to which this attribute belongs.

Returns:boolean

true if the non-normalized and normalized value are the same

Note

This method uses fStringBuffer2, anything in it at the time of calling is lost.

Scans a character reference and append the corresponding chars to the specified buffer.

[66] CharRef ::= '&#' [0-9]+ ';' | '&#x' [0-9a-fA-F]+ ';'

Parameters

buf:XMLStringBuffer

the character buffer to append chars to

buf2:XMLStringBuffer

the character buffer to append non-normalized chars to

Returns:int

the character value or (-1) on conversion failure

Scans a comment.

[15] Comment ::= '<!--' ((Char - '-') | ('-' (Char - '-')))* '-->'

Parameters

text:XMLStringBuffer

The buffer to fill in with the text.

Scans External ID and return the public and system IDs.

Parameters

identifiers:String[]

An array of size 2 to return the system id, and public id (in that order).

optionalSystemId:boolean

Specifies whether the system id is optional

Note

This method uses fString and fStringBuffer, anything in them at the time of calling is lost.

Scans a processing instruction.

[16] PI ::= '<?' PITarget (S (Char* - (Char* '?>' Char*)))? '?>'
[17] PITarget ::= Name - (('X' | 'x') ('M' | 'm') ('L' | 'l'))

Scans a processing data. This is needed to handle the situation where a document starts with a processing instruction whose target name starts with "xml". (e.g. xmlfoo)

Parameters

target:String

The PI target

data:XMLString

The string to fill in with the data

Scans public ID literal. [12] PubidLiteral ::= '"' PubidChar* '"' | "'" (PubidChar - "'")* "'" [13] PubidChar::= #x20 | #xD | #xA | [a-zA-Z0-9] | [-'()+,./:=?;!*#@$_%] The returned string is normalized according to the following rule, from http://www.w3.org/TR/REC-xml#dt-pubid: Before a match is attempted, all strings of white space in the public identifier must be normalized to single space characters (#x20), and leading and trailing white space must be removed.

Parameters

literal:XMLString

The string to fill in with the public ID literal.

Returns:boolean

True on success

Note

This method uses fStringBuffer, anything in it at the time of calling is lost.

Scans surrogates and append them to the specified buffer.

Parameters

buf:XMLStringBuffer

The StringBuffer to append the read surrogates to.

Returns:boolean

True if it succeeded.

Scans an XML or text declaration.

[23] XMLDecl ::= '<?xml' VersionInfo EncodingDecl? SDDecl? S? '?>'
[24] VersionInfo ::= S 'version' Eq (' VersionNum ' | " VersionNum ")
[80] EncodingDecl ::= S 'encoding' Eq ('"' EncName '"' |  "'" EncName "'" )
[81] EncName ::= [A-Za-z] ([A-Za-z0-9._] | '-')*
[32] SDDecl ::= S 'standalone' Eq (("'" ('yes' | 'no') "'")
                | ('"' ('yes' | 'no') '"'))

[77] TextDecl ::= '<?xml' VersionInfo? EncodingDecl S? '?>'

Parameters

scanningTextDecl:boolean

True if a text declaration is to be scanned instead of an XML declaration.

pseudoAttributeValues:String[]

An array of size 3 to return the version, encoding and standalone pseudo attribute values (in that order)

Note

This method uses fString, anything in it at the time of calling is lost.