Top Description Fields Constructors Methods
com.sun.org.apache.xml.internal.serializer

public final Class ToTextStream

extends ToStream
Class Inheritance
Imports
java.io.IOException, com.sun.org.apache.xml.internal.serializer.utils.MsgKey, .Utils, javax.xml.transform.ErrorListener, org.xml.sax.Attributes, .SAXException

This class is not a public API. It is only public because it is used in other packages. This class converts SAX or SAX-like calls to a serialized document for xsl:output method of "text".

Field Summary

Inherited from com.sun.org.apache.xml.internal.serializer.ToStream:
m_canConvertMethm_cdataStartCalledm_charactersBufferm_charInfom_charToByteConverterm_childNodeNumm_childNodeNumStackm_disableOutputEscapingStatesm_encodingInfom_inDoctypem_ispreserveSpacem_isprevtextm_isUTF8m_lineSepm_lineSepLenm_lineSepUsem_maxCharacterm_outputStreamm_preserveSpacesm_shouldFlushm_spaceBeforeClosem_startNewLinem_triedToGetConverter

Constructor Summary

AccessConstructor and Description
public
ToTextStream()

Default constructor.

public

Method Summary

Modifier and TypeMethod and Description
public void
addAttribute(String
the URI of the attribute
uri
,
String
the local name of the attribute
localName
,
String
the qualified name of the attribute
rawName
,
String
the type of the attribute (probably CDATA)
type
,
String
the value of the attribute
value
,
boolean
true if this attribute is coming from an xsl:attriute element
XSLAttribute
)

Overrides com.sun.org.apache.xml.internal.serializer.SerializerBase.addAttribute.

Implements com.sun.org.apache.xml.internal.serializer.ExtendedContentHandler.addAttribute.

Adds the given attribute to the set of collected attributes , but only if there is a currently open element.

public void
public void
addUniqueAttribute(String
the fully qualified attribute name.
qName
,
String
the attribute value
value
,
int
a bitwise flag
flags
)

Implements com.sun.org.apache.xml.internal.serializer.ExtendedContentHandler.addUniqueAttribute.

Add a unique attribute

public void
cdata(char[]
The characters from the XML document.
ch
,
int
The start position in the array.
start
,
int
The number of characters to read from the array.
length
)

Overrides com.sun.org.apache.xml.internal.serializer.ToStream.cdata.

Receive notification of cdata.

public void
characters(char[]
The characters from the XML document.
ch
,
int
The start position in the array.
start
,
int
The number of characters to read from the array.
length
)

Overrides com.sun.org.apache.xml.internal.serializer.ToStream.characters.

Implements org.xml.sax.ContentHandler.characters.

Receive notification of character data.

public void
public void
charactersRaw(char[]
The characters from the XML document.
ch
,
int
The start position in the array.
start
,
int
The number of characters to read from the array.
length
)

Overrides com.sun.org.apache.xml.internal.serializer.ToStream.charactersRaw.

If available, when the disable-output-escaping attribute is used, output raw text without escaping.

public void
public void
comment(char[]
An array holding the characters in the comment.
ch
,
int
The starting position in the array.
start
,
int
The number of characters to use from the array.
length
)

Overrides com.sun.org.apache.xml.internal.serializer.ToStream.comment.

Implements org.xml.sax.ext.LexicalHandler.comment.

Report an XML comment anywhere in the document.

public void
public void
endDocument()

Implements org.xml.sax.ContentHandler.endDocument.

Receive notification of the end of a document.

public void
endElement(String
The Namespace URI, or the empty string if the element has no Namespace URI or if Namespace processing is not being performed.
namespaceURI
,
String
The local name (without prefix), or the empty string if Namespace processing is not being performed.
localName
,
String
The qualified name (with prefix), or the empty string if qualified names are not available.
name
)

Overrides com.sun.org.apache.xml.internal.serializer.ToStream.endElement.

Implements org.xml.sax.ContentHandler.endElement.

Receive notification of the end of an element.

public void
endElement(String
The element type name
elemName
)

Overrides com.sun.org.apache.xml.internal.serializer.ToStream.endElement.

Implements com.sun.org.apache.xml.internal.serializer.ExtendedContentHandler.endElement.

Receive notification of the end of an element.

public void
entityReference(String
non-null reference to the name of the entity.
name
)

Overrides com.sun.org.apache.xml.internal.serializer.SerializerBase.entityReference.

Implements com.sun.org.apache.xml.internal.serializer.ExtendedContentHandler.entityReference.

Receive notivication of a entityReference.

public void
flushPending()

Overrides com.sun.org.apache.xml.internal.serializer.ToStream.flushPending.

Implements com.sun.org.apache.xml.internal.serializer.SerializationHandler.flushPending.

This method flushes any pending events, which can be startDocument() closing the opening tag of an element, or closing an open CDATA section.

public void
ignorableWhitespace(char[]
The characters from the XML document.
ch
,
int
The start position in the array.
start
,
int
The number of characters to read from the array.
length
)

Overrides com.sun.org.apache.xml.internal.serializer.ToStream.ignorableWhitespace.

Implements org.xml.sax.ContentHandler.ignorableWhitespace.

Receive notification of ignorable whitespace in element content.

public void
namespaceAfterStartElement(final String
the URI of the namespace
prefix
,
final String
the prefix associated with the given URI.
uri
)

Overrides com.sun.org.apache.xml.internal.serializer.SerializerBase.namespaceAfterStartElement.

Implements com.sun.org.apache.xml.internal.serializer.ExtendedContentHandler.namespaceAfterStartElement.

This method is used when a prefix/uri namespace mapping is indicated after the element was started with a startElement() and before and endElement().

public void
processingInstruction(String
The processing instruction target.
target
,
String
The processing instruction data, or null if none was supplied.
data
)

Implements org.xml.sax.ContentHandler.processingInstruction.

Receive notification of a processing instruction.

protected void
startDocumentInternal()

Overrides com.sun.org.apache.xml.internal.serializer.SerializerBase.startDocumentInternal.

Receive notification of the beginning of a document.

public void
startElement(String
The Namespace URI, or the empty string if the element has no Namespace URI or if Namespace processing is not being performed.
namespaceURI
,
String
The local name (without prefix), or the empty string if Namespace processing is not being performed.
localName
,
String
The qualified name (with prefix), or the empty string if qualified names are not available.
name
,
Attributes
The attributes attached to the element, if any.
atts
)

Overrides com.sun.org.apache.xml.internal.serializer.ToStream.startElement.

Implements org.xml.sax.ContentHandler.startElement.

Receive notification of the beginning of an element.

public void
startElement(String
The Namespace URI, or the empty string if the element has no Namespace URI or if Namespace processing is not being performed.
elementNamespaceURI
,
String
The local name (without prefix), or the empty string if Namespace processing is not being performed.
elementLocalName
,
String
The element type name.
elementName
)

Overrides com.sun.org.apache.xml.internal.serializer.ToStream.startElement.

Implements com.sun.org.apache.xml.internal.serializer.ExtendedContentHandler.startElement.

From XSLTC

public boolean
startPrefixMapping(String
The Namespace prefix being declared.
prefix
,
String
The Namespace URI the prefix is mapped to.
uri
,
boolean
true if any open tags need to be closed first, this will impact which element the mapping applies to (open parent, or its up comming child)
shouldFlush
)

Overrides com.sun.org.apache.xml.internal.serializer.ToStream.startPrefixMapping.

Implements com.sun.org.apache.xml.internal.serializer.ExtendedContentHandler.startPrefixMapping.

Handle a prefix/uri mapping, which is associated with a startElement() that is soon to follow.

public void
startPrefixMapping(String
The Namespace prefix being declared.
prefix
,
String
The Namespace URI the prefix is mapped to.
uri
)

Overrides com.sun.org.apache.xml.internal.serializer.ToStream.startPrefixMapping.

Implements org.xml.sax.ContentHandler.startPrefixMapping.

Begin the scope of a prefix-URI Namespace mapping just before another element is about to start.

pack-priv void
writeNormalizedChars(final char[]
The characters from the XML document.
ch
,
final int
The start position in the array.
start
,
final int
The number of characters to read from the array.
length
,
final boolean
true if the operating systems end-of-line separator should be output rather than a new-line character.
useLineSep
)

Normalize the characters, but don't escape.

Inherited from com.sun.org.apache.xml.internal.serializer.ToStream:
accumDefaultEntityaccumDefaultEscapeaddAttributeAlwaysaddCdataSectionElementsattributeDeclcloseCDATAcloseStartTagelementDeclendDTDendNonEscapingendPrefixMappingensureAttributesNamespaceIsDeclaredensurePrefixIsDeclaredescapingNotNeededexternalEntityDeclfirePseudoAttributesflushCharactersBufferflushWritergetIndentgetIndentAmountgetOutputFormatgetOutputStreamgetWriterindentindentinternalEntityDeclisUTF16SurrogatenotationDecloutputDocTypeDecloutputEntityDecloutputLineSepprocessAttributesresetserializesetCdataSectionElementssetContentHandlersetDTDEntityExpansionsetEncodingsetEscapingsetIndentAmountsetLineSepUsesetOutputFormatsetOutputStreamsetPropsetTransformersetWritershouldFormatOutputshouldIndentshouldIndentForTextskippedEntitystartCDATAstartDTDstartElementstartEntitystartNonEscapingunparsedEntityDeclwriteAttrStringwriteNormalizedCharswriteUTF16Surrogate

Constructor Detail

ToTextStreamback to summary
public ToTextStream()

Default constructor.

ToTextStreamback to summary
public ToTextStream(ErrorListener l)

Method Detail

addAttributeback to summary
public void addAttribute(String uri, String localName, String rawName, String type, String value, boolean XSLAttribute)

Overrides com.sun.org.apache.xml.internal.serializer.SerializerBase.addAttribute.

Implements com.sun.org.apache.xml.internal.serializer.ExtendedContentHandler.addAttribute.

Doc from com.sun.org.apache.xml.internal.serializer.SerializerBase.addAttribute.

Adds the given attribute to the set of collected attributes , but only if there is a currently open element. An element is currently open if a startElement() notification has occured but the start of the element has not yet been written to the output. In the stream case this means that we have not yet been forced to close the elements opening tag by another notification, such as a character notification.

Parameters
uri:String

the URI of the attribute

localName:String

the local name of the attribute

rawName:String

the qualified name of the attribute

type:String

the type of the attribute (probably CDATA)

value:String

the value of the attribute

XSLAttribute:boolean

true if this attribute is coming from an xsl:attriute element

See Also
ExtendedContentHandler#addAttribute(String, String, String, String, String)
addAttributeback to summary
public void addAttribute(String name, String value)

Overrides com.sun.org.apache.xml.internal.serializer.SerializerBase.addAttribute.

Implements com.sun.org.apache.xml.internal.serializer.ExtendedContentHandler.addAttribute.

From XSLTC

Parameters
name:String

Doc from com.sun.org.apache.xml.internal.serializer.SerializerBase.addAttribute.

the attribute's qualified name

value:String

Doc from com.sun.org.apache.xml.internal.serializer.SerializerBase.addAttribute.

the value of the attribute

addUniqueAttributeback to summary
public void addUniqueAttribute(String qName, String value, int flags) throws SAXException

Implements com.sun.org.apache.xml.internal.serializer.ExtendedContentHandler.addUniqueAttribute.

Add a unique attribute

Parameters
qName:String

Doc from com.sun.org.apache.xml.internal.serializer.ExtendedContentHandler.addUniqueAttribute.

the fully qualified attribute name.

value:String

Doc from com.sun.org.apache.xml.internal.serializer.ExtendedContentHandler.addUniqueAttribute.

the attribute value

flags:int

Doc from com.sun.org.apache.xml.internal.serializer.ExtendedContentHandler.addUniqueAttribute.

a bitwise flag

cdataback to summary
public void cdata(char[] ch, int start, int length) throws SAXException

Overrides com.sun.org.apache.xml.internal.serializer.ToStream.cdata.

Receive notification of cdata.

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.

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

Parameters
ch:char[]

The characters from the XML document.

start:int

The start position in the array.

length:int

The number of characters to read from the array.

Exceptions
SAXException:
Any SAX exception, possibly wrapping another exception.
See Also
ignorableWhitespace, org.xml.sax.Locator
charactersback to summary
public void characters(char[] ch, int start, int length) throws SAXException

Overrides com.sun.org.apache.xml.internal.serializer.ToStream.characters.

Implements 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.

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

Parameters
ch:char[]

The characters from the XML document.

start:int

The start position in the array.

length:int

The number of characters to read from the array.

Exceptions
SAXException:
Any SAX exception, possibly wrapping another exception.
See Also
ignorableWhitespace, org.xml.sax.Locator
charactersback to summary
public void characters(String characters) throws SAXException

Overrides com.sun.org.apache.xml.internal.serializer.ToStream.characters.

Implements com.sun.org.apache.xml.internal.serializer.ExtendedContentHandler.characters.

From XSLTC

Parameters
characters:String

Doc from com.sun.org.apache.xml.internal.serializer.ToStream.characters.

The string of characters to process.

charactersRawback to summary
public void charactersRaw(char[] ch, int start, int length) throws SAXException

Overrides com.sun.org.apache.xml.internal.serializer.ToStream.charactersRaw.

If available, when the disable-output-escaping attribute is used, output raw text without escaping.

Parameters
ch:char[]

The characters from the XML document.

start:int

The start position in the array.

length:int

The number of characters to read from the array.

Exceptions
SAXException:
Any SAX exception, possibly wrapping another exception.
commentback to summary
public void comment(String data) throws SAXException

Overrides com.sun.org.apache.xml.internal.serializer.SerializerBase.comment.

Implements com.sun.org.apache.xml.internal.serializer.ExtendedLexicalHandler.comment.

Called when a Comment is to be constructed. Note that Xalan will normally invoke the other version of this method. %REVIEW% In fact, is this one ever needed, or was it a mistake?

Parameters
data:String

The comment data.

Exceptions
SAXException:
Any SAX exception, possibly wrapping another exception.
commentback to summary
public void comment(char[] ch, int start, int length) throws SAXException

Overrides com.sun.org.apache.xml.internal.serializer.ToStream.comment.

Implements org.xml.sax.ext.LexicalHandler.comment.

Report an XML comment anywhere in the document. This callback will be used for comments inside or outside the document element, including comments in the external DTD subset (if read).

Parameters
ch:char[]

An array holding the characters in the comment.

start:int

The starting position in the array.

length:int

The number of characters to use from the array.

Exceptions
SAXException:
The application may raise an exception.
endCDATAback to summary
public void endCDATA() throws SAXException

Overrides com.sun.org.apache.xml.internal.serializer.ToStream.endCDATA.

Implements org.xml.sax.ext.LexicalHandler.endCDATA.

Doc from com.sun.org.apache.xml.internal.serializer.ToStream.endCDATA.

Report the end of a CDATA section.

Exceptions
SAXException:
The application may raise an exception.
See Also
org.xml.sax.ext.LexicalHandler#endCDATA()
endDocumentback to summary
public void endDocument() throws SAXException

Implements org.xml.sax.ContentHandler.endDocument.

Receive notification of the end of a document.

The SAX parser will invoke this method only once, and it will be the last method invoked during the parse. The parser shall not invoke this method until it has either abandoned parsing (because of an unrecoverable error) or reached the end of input.

Exceptions
SAXException:
Any SAX exception, possibly wrapping another exception.
endElementback to summary
public void endElement(String namespaceURI, String localName, String name) throws SAXException

Overrides com.sun.org.apache.xml.internal.serializer.ToStream.endElement.

Implements org.xml.sax.ContentHandler.endElement.

Receive notification of the end of an element.

The SAX parser will invoke this method at the end of every element in the XML document; there will be a corresponding startElement() event for every endElement() event (even when the element is empty).

If the element name has a namespace prefix, the prefix will still be attached to the name.

Parameters
namespaceURI:String

The Namespace URI, or the empty string if the element has no Namespace URI or if Namespace processing is not being performed.

localName:String

The local name (without prefix), or the empty string if Namespace processing is not being performed.

name:String

The qualified name (with prefix), or the empty string if qualified names are not available.

Exceptions
SAXException:
Any SAX exception, possibly wrapping another exception.
endElementback to summary
public void endElement(String elemName) throws SAXException

Overrides com.sun.org.apache.xml.internal.serializer.ToStream.endElement.

Implements com.sun.org.apache.xml.internal.serializer.ExtendedContentHandler.endElement.

Doc from com.sun.org.apache.xml.internal.serializer.ToStream.endElement.

Receive notification of the end of an element.

Parameters
elemName:String

The element type name

Exceptions
SAXException:
Any SAX exception, possibly wrapping another exception.
See Also
ExtendedContentHandler#endElement(String)
entityReferenceback to summary
public void entityReference(String name) throws SAXException

Overrides com.sun.org.apache.xml.internal.serializer.SerializerBase.entityReference.

Implements com.sun.org.apache.xml.internal.serializer.ExtendedContentHandler.entityReference.

Receive notivication of a entityReference.

Parameters
name:String

non-null reference to the name of the entity.

flushPendingback to summary
public void flushPending() throws SAXException

Overrides com.sun.org.apache.xml.internal.serializer.ToStream.flushPending.

Implements com.sun.org.apache.xml.internal.serializer.SerializationHandler.flushPending.

Doc from com.sun.org.apache.xml.internal.serializer.ToStream.flushPending.

This method flushes any pending events, which can be startDocument() closing the opening tag of an element, or closing an open CDATA section.

ignorableWhitespaceback to summary
public void ignorableWhitespace(char[] ch, int start, int length) throws SAXException

Overrides com.sun.org.apache.xml.internal.serializer.ToStream.ignorableWhitespace.

Implements org.xml.sax.ContentHandler.ignorableWhitespace.

Receive notification of ignorable whitespace in element content.

Validating Parsers must use this method to report each chunk of ignorable whitespace (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
ch:char[]

The characters from the XML document.

start:int

The start position in the array.

length:int

The number of characters to read from the array.

Exceptions
SAXException:
Any SAX exception, possibly wrapping another exception.
See Also
characters
namespaceAfterStartElementback to summary
public void namespaceAfterStartElement(final String prefix, final String uri) throws SAXException

Overrides com.sun.org.apache.xml.internal.serializer.SerializerBase.namespaceAfterStartElement.

Implements com.sun.org.apache.xml.internal.serializer.ExtendedContentHandler.namespaceAfterStartElement.

Doc from com.sun.org.apache.xml.internal.serializer.SerializerBase.namespaceAfterStartElement.

This method is used when a prefix/uri namespace mapping is indicated after the element was started with a startElement() and before and endElement(). startPrefixMapping(prefix,uri) would be used before the startElement() call.

Parameters
prefix:String

the URI of the namespace

uri:String

the prefix associated with the given URI.

processingInstructionback to summary
public void processingInstruction(String target, String data) throws SAXException

Implements org.xml.sax.ContentHandler.processingInstruction.

Receive notification of a processing instruction.

The Parser will invoke this method once for each processing instruction found: note that processing instructions may occur before or after the main document element.

A SAX parser should never report an XML declaration (XML 1.0, section 2.8) or a text declaration (XML 1.0, section 4.3.1) using this method.

Parameters
target:String

The processing instruction target.

data:String

The processing instruction data, or null if none was supplied.

Exceptions
SAXException:
Any SAX exception, possibly wrapping another exception.
startDocumentInternalback to summary
protected void startDocumentInternal() throws SAXException

Overrides com.sun.org.apache.xml.internal.serializer.SerializerBase.startDocumentInternal.

Receive notification of the beginning of a document.

The SAX parser will invoke this method only once, before any other methods in this interface or in DTDHandler (except for setDocumentLocator).

Exceptions
SAXException:
Any SAX exception, possibly wrapping another exception.
startElementback to summary
public void startElement(String namespaceURI, String localName, String name, Attributes atts) throws SAXException

Overrides com.sun.org.apache.xml.internal.serializer.ToStream.startElement.

Implements org.xml.sax.ContentHandler.startElement.

Receive notification of the beginning of an element.

The Parser will invoke this method at the beginning of every element in the XML document; there will be a corresponding endElement() event for every startElement() event (even when the element is empty). All of the element's content will be reported, in order, before the corresponding endElement() event.

If the element name has a namespace prefix, the prefix will still be attached. Note that the attribute list provided will contain only attributes with explicit values (specified or defaulted): #IMPLIED attributes will be omitted.

Parameters
namespaceURI:String

The Namespace URI, or the empty string if the element has no Namespace URI or if Namespace processing is not being performed.

localName:String

The local name (without prefix), or the empty string if Namespace processing is not being performed.

name:String

The qualified name (with prefix), or the empty string if qualified names are not available.

atts:Attributes

The attributes attached to the element, if any.

Exceptions
SAXException:
Any SAX exception, possibly wrapping another exception.
See Also
endElement, org.xml.sax.AttributeList
startElementback to summary
public void startElement(String elementNamespaceURI, String elementLocalName, String elementName) throws SAXException

Overrides com.sun.org.apache.xml.internal.serializer.ToStream.startElement.

Implements com.sun.org.apache.xml.internal.serializer.ExtendedContentHandler.startElement.

From XSLTC

Parameters
elementNamespaceURI:String

Doc from com.sun.org.apache.xml.internal.serializer.ToStream.startElement.

The Namespace URI, or the empty string if the element has no Namespace URI or if Namespace processing is not being performed.

elementLocalName:String

Doc from com.sun.org.apache.xml.internal.serializer.ToStream.startElement.

The local name (without prefix), or the empty string if Namespace processing is not being performed.

elementName:String

Doc from com.sun.org.apache.xml.internal.serializer.ToStream.startElement.

The element type name.

Exceptions
SAXException:

Doc from com.sun.org.apache.xml.internal.serializer.ToStream.startElement.

Any SAX exception, possibly wrapping another exception.

startPrefixMappingback to summary
public boolean startPrefixMapping(String prefix, String uri, boolean shouldFlush) throws SAXException

Overrides com.sun.org.apache.xml.internal.serializer.ToStream.startPrefixMapping.

Implements com.sun.org.apache.xml.internal.serializer.ExtendedContentHandler.startPrefixMapping.

Doc from com.sun.org.apache.xml.internal.serializer.ToStream.startPrefixMapping.

Handle a prefix/uri mapping, which is associated with a startElement() that is soon to follow. Need to close any open start tag to make sure than any name space attributes due to this event are associated wih the up comming element, not the current one.

Parameters
prefix:String

The Namespace prefix being declared.

uri:String

The Namespace URI the prefix is mapped to.

shouldFlush:boolean

true if any open tags need to be closed first, this will impact which element the mapping applies to (open parent, or its up comming child)

Returns:boolean

returns true if the call made a change to the current namespace information, false if it did not change anything, e.g. if the prefix/namespace mapping was already in scope from before.

Exceptions
SAXException:
The client may throw an exception during processing.
startPrefixMappingback to summary
public void startPrefixMapping(String prefix, String uri) throws SAXException

Overrides com.sun.org.apache.xml.internal.serializer.ToStream.startPrefixMapping.

Implements org.xml.sax.ContentHandler.startPrefixMapping.

Doc from com.sun.org.apache.xml.internal.serializer.ToStream.startPrefixMapping.

Begin the scope of a prefix-URI Namespace mapping just before another element is about to start. This call will close any open tags so that the prefix mapping will not apply to the current element, but the up comming child.

Parameters
prefix:String

The Namespace prefix being declared.

uri:String

The Namespace URI the prefix is mapped to.

Exceptions
SAXException:
The client may throw an exception during processing.
writeNormalizedCharsback to summary
pack-priv void writeNormalizedChars(final char[] ch, final int start, final int length, final boolean useLineSep) throws IOException, SAXException

Normalize the characters, but don't escape. Different from SerializerToXML#writeNormalizedChars because it does not attempt to do XML escaping at all.

Parameters
ch:char[]

The characters from the XML document.

start:int

The start position in the array.

length:int

The number of characters to read from the array.

useLineSep:boolean

true if the operating systems end-of-line separator should be output rather than a new-line character.