## org.apache.xpath.objects
Class XStringForChars

    java.lang.Object
      |
      +--org.apache.xpath.Expression
            |
            +--org.apache.xpath.objects.XObject
                  |
                  +--org.apache.xpath.objects.XString
                        |
                        +--org.apache.xpath.objects.XStringForChars

public class XStringForChars
extends XString

This class will wrap a FastStringBuffer and allow for

See Also:
  Serialized Form

Fields inherited from class org.apache.xpath.objects.XString
`EMPTYSTRING`

Fields inherited from class org.apache.xpath.objects.XObject
`CLASS_BOOLEAN, CLASS_NODESET, CLASS_NULL, CLASS_NUMBER, CLASS_RTREEFRAG, CLASS_STRING, CLASS_UNKNOWN, CLASS_UNRESOLVEDVARIABLE`

Constructor Summary
`XStringForChars(char[] val, int start, int length)` Construct a XNodeSet object.

Method Summary
`void` `appendToFsb(FastStringBuffer fsb)` Cast result object to a string.
`char` `charAt(int index)` Returns the character at the specified index.
`void` `dispatchAsComment(LexicalHandler lh)` Directly call the comment method on the passed LexicalHandler for the string-value.
`void` `dispatchCharactersEvents(ContentHandler ch)` Directly call the characters method on the passed ContentHandler for the string-value.
`FastStringBuffer` `fsb()` Cast result object to a string.
`void` `getChars(int srcBegin, int srcEnd, char[] dst, int dstBegin)` Copies characters from this string into the destination character array.
`boolean` `hasString()` Tell if this object contains a java String object.
`int` `length()` Returns the length of this string.
`java.lang.Object` `object()` Since this object is incomplete without the length and the offset, we have to convert to a string when this function is called.
`java.lang.String` `str()` Cast result object to a string.

Methods inherited from class org.apache.xpath.objects.XString

`bool, callVisitors, compareTo, compareToIgnoreCase, concat, endsWith, equals, equals, equals, equals, equalsIgnoreCase, fixWhiteSpace, getType, getTypeString, hashCode, indexOf, indexOf, indexOf, indexOf, indexOf, lastIndexOf, lastIndexOf, lastIndexOf, lastIndexOf, num, rtf, startsWith, startsWith, startsWith, startsWith, substring, substring, toDouble, toLowerCase, toLowerCase, toUpperCase, toUpperCase, trim, xstr`

Methods inherited from class org.apache.xpath.objects.XObject
`allowDetachToRelease, boolWithSideEffects, castToType, create, create, deepEquals, destruct, detach, execute, fixupVariables, getFresh, greaterThan, greaterThanOrEqual, iter, lessThan, lessThanOrEqual, mutableNodeset, nodelist, nodeset, notEquals, numWithSideEffects, reset, rtf, rtree, rtree, toString`

Methods inherited from class org.apache.xpath.Expression
`asIterator, asIteratorRaw, asNode, assertion, bool, canTraverseOutsideSubtree, error, execute, execute, execute, executeCharsToContentHandler, exprAddChild, exprGetChild, exprGetNumChildren, exprGetParent, exprSetParent, getColumnNumber, getExpressionOwner, getLineNumber, getPublicId, getSystemId, isNodesetExpr, isStableNumber, num, warn, xstr`

Methods inherited from class java.lang.Object
`getClass, notify, notifyAll, wait, wait, wait`

Constructor Detail

### XStringForChars

    public XStringForChars(char[] val,
                           int start,
                           int length)

  Construct a XNodeSet object.
  Parameters:
    `val` - FastStringBuffer object this will wrap, must be non-null.
    `start` - The start position in the array.
    `length` - The number of characters to read from the array.

Method Detail

### fsb

    public FastStringBuffer fsb()

  Cast result object to a string.
  Returns:
    The string this wraps or the empty string if null

### appendToFsb

    public void appendToFsb(FastStringBuffer fsb)

  Cast result object to a string.
  Returns:
    The string this wraps or the empty string if null
  Overrides:
    appendToFsb in class XObject

### hasString

    public boolean hasString()

  Tell if this object contains a java String object.
  Returns:
    true if this XMLString can return a string without creating one.
  Overrides:
    hasString in class XString

### str

    public java.lang.String str()

  Cast result object to a string.
  Returns:
    The string this wraps or the empty string if null
  Overrides:
    str in class XString

### object

    public java.lang.Object object()

  Since this object is incomplete without the length and the offset, we have to convert to a string when this function is called.
  Returns:
    The java String representation of this object.
  Overrides:
    object in class XObject

### dispatchCharactersEvents

    public void dispatchCharactersEvents(ContentHandler ch)
                                  throws SAXException

  Directly call the characters method on the passed ContentHandler for the string-value. Multiple calls to the ContentHandler's characters methods may well occur for a single call to this method.
  Parameters:
    `ch` - A non-null reference to a ContentHandler.
  Throws:
    SAXException -
  Overrides:
    dispatchCharactersEvents in class XString

### dispatchAsComment

    public void dispatchAsComment(LexicalHandler lh)
                           throws SAXException

  Directly call the comment method on the passed LexicalHandler for the string-value.
  Parameters:
    `lh` - A non-null reference to a LexicalHandler.
  Throws:
    SAXException -
  Overrides:
    dispatchAsComment in class XString

### length

    public int length()

  Returns the length of this string.
  Returns:
    the length of the sequence of characters represented by this object.
  Overrides:
    length in class XString

### charAt

    public char charAt(int index)

  Returns the character at the specified index. An index ranges from `0` to `length() - 1`. The first character of the sequence is at index `0`, the next at index `1`, and so on, as for array indexing.
  Parameters:
    `index` - the index of the character.
  Returns:
    the character at the specified index of this string. The first character is at index `0`.
  Throws:
    java.lang.IndexOutOfBoundsException - if the `index` argument is negative or not less than the length of this string.
  Overrides:
    charAt in class XString

### getChars

    public void getChars(int srcBegin,
                         int srcEnd,
                         char[] dst,
                         int dstBegin)

  Copies characters from this string into the destination character array.
  Parameters:
    `srcBegin` - index of the first character in the string to copy.
    `srcEnd` - index after the last character in the string to copy.
    `dst` - the destination array.
    `dstBegin` - the start offset in the destination array.
  Throws:
    java.lang.IndexOutOfBoundsException - If any of the following is true:
    - `srcBegin` is negative.
    - `srcBegin` is greater than `srcEnd`
    - `srcEnd` is greater than the length of this string
    - `dstBegin` is negative
    - `dstBegin+(srcEnd-srcBegin)` is larger than `dst.length`
    java.lang.NullPointerException - if `dst` is `null`
  Overrides:
    getChars in class XString

Copyright © 2006 Apache XML Project. All Rights Reserved.