MSV Core 2022.7 · com.sun.msv.reader.trex.classic.StringState

Modifier and Type	Field and Description
protected final StringBuffer	text

Access	Constructor and Description
public	StringState()

Method Summary

Modifier and Type	Method and Description
public void	characters(char[] the characters from the XML document buf, int the start position in the array from, int the number of characters to read from the array len) Overrides com.sun.msv.reader.State.characters. Implements org.xml.sax.ContentHandler.characters. Receive notification of character data.
public void	ignorableWhitespace(char[] the characters from the XML document buf, int the start position in the array from, int the number of characters to read from the array len) Overrides com.sun.msv.reader.State.ignorableWhitespace. Implements org.xml.sax.ContentHandler.ignorableWhitespace. Receive notification of ignorable whitespace in element content.
protected Expression	makeExpression() Implements abstract com.sun.msv.reader.ExpressionState.makeExpression. This method is called from endElement method.

Inherited from com.sun.msv.reader.ExpressionWithoutChildState:: createChildState

text	back to summary
protected final StringBuffer text

StringState	back to summary
public StringState()

Method Detail

characters back to summary

characters	back to summary
public void characters(char[] buf, int from, int len) Overrides com.sun.msv.reader.State.characters. Implements org.xml.sax.ContentHandler.characters. Doc from org.xml.sax.ContentHandler.characters. Receive notification of character data. The Parser will call this method to report each chunk of character data. SAX parsers may return all contiguous character data in a single chunk, or they may split it into several chunks; however, all of the characters in any single event must come from the same external entity so that the Locator provides useful information. The application must not attempt to read from the array outside of the specified range. Individual characters may consist of more than one Java `char` value. There are two important cases where this happens, because characters can't be represented in just sixteen bits. In one case, characters are represented in a Surrogate Pair, using two special Unicode values. Such characters are in the so-called "Astral Planes", with a code point above U+FFFF. A second case involves composite characters, such as a base character combining with one or more accent characters. Your code should not assume that algorithms using `char`-at-a-time idioms will be working in character units; in some cases they will split characters. This is relevant wherever XML permits arbitrary characters, such as attribute values, processing instruction data, and comments as well as in data reported from this method. It's also generally relevant whenever Java code manipulates internationalized text; the issue isn't unique to XML. Note that some parsers will report whitespace in element content using the `ignorableWhitespace` method rather than this one (validating parsers must do so). Parameters buf:char[] the characters from the XML document from:int the start position in the array len:int the number of characters to read from the array

public void characters(char[] buf, int from, int len)

Overrides com.sun.msv.reader.State.characters.

Implements org.xml.sax.ContentHandler.characters.

Doc from org.xml.sax.ContentHandler.characters.

Receive notification of character data.

The Parser will call this method to report each chunk of character data. SAX parsers may return all contiguous character data in a single chunk, or they may split it into several chunks; however, all of the characters in any single event must come from the same external entity so that the Locator provides useful information.

The application must not attempt to read from the array outside of the specified range.

Individual characters may consist of more than one Java char value. There are two important cases where this happens, because characters can't be represented in just sixteen bits. In one case, characters are represented in a Surrogate Pair, using two special Unicode values. Such characters are in the so-called "Astral Planes", with a code point above U+FFFF. A second case involves composite characters, such as a base character combining with one or more accent characters.

Your code should not assume that algorithms using char-at-a-time idioms will be working in character units; in some cases they will split characters. This is relevant wherever XML permits arbitrary characters, such as attribute values, processing instruction data, and comments as well as in data reported from this method. It's also generally relevant whenever Java code manipulates internationalized text; the issue isn't unique to XML.

Note that some parsers will report whitespace in element content using the ignorableWhitespace method rather than this one (validating parsers must do so).

Parameters

buf:char[]: the characters from the XML document
from:int: the start position in the array
len:int: the number of characters to read from the array

ignorableWhitespace	back to summary
public void ignorableWhitespace(char[] buf, int from, int len) Overrides com.sun.msv.reader.State.ignorableWhitespace. Implements org.xml.sax.ContentHandler.ignorableWhitespace. Doc from org.xml.sax.ContentHandler.ignorableWhitespace. Receive notification of ignorable whitespace in element content. Validating Parsers must use this method to report each chunk of whitespace in element content (see the W3C XML 1.0 recommendation, section 2.10): non-validating parsers may also use this method if they are capable of parsing and using content models. SAX parsers may return all contiguous whitespace in a single chunk, or they may split it into several chunks; however, all of the characters in any single event must come from the same external entity, so that the Locator provides useful information. The application must not attempt to read from the array outside of the specified range. Parameters buf:char[] the characters from the XML document from:int the start position in the array len:int the number of characters to read from the array

ignorableWhitespace

back to summary

public void ignorableWhitespace(char[] buf, int from, int len)

Overrides com.sun.msv.reader.State.ignorableWhitespace.

Implements org.xml.sax.ContentHandler.ignorableWhitespace.

Doc from org.xml.sax.ContentHandler.ignorableWhitespace.

Receive notification of ignorable whitespace in element content.

Validating Parsers must use this method to report each chunk of whitespace in element content (see the W3C XML 1.0 recommendation, section 2.10): non-validating parsers may also use this method if they are capable of parsing and using content models.

SAX parsers may return all contiguous whitespace in a single chunk, or they may split it into several chunks; however, all of the characters in any single event must come from the same external entity, so that the Locator provides useful information.

The application must not attempt to read from the array outside of the specified range.

Parameters

buf:char[]: the characters from the XML document
from:int: the start position in the array
len:int: the number of characters to read from the array

makeExpression	back to summary
protected Expression makeExpression() Implements abstract com.sun.msv.reader.ExpressionState.makeExpression. Doc from com.sun.msv.reader.ExpressionState.makeExpression. This method is called from endElement method. Implementation has to provide Expression object that represents the content of this element.

makeExpression

back to summary

protected Expression makeExpression()

Implements abstract com.sun.msv.reader.ExpressionState.makeExpression.

Doc from com.sun.msv.reader.ExpressionState.makeExpression.

This method is called from endElement method. Implementation has to provide Expression object that represents the content of this element.

public Class StringState

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail