Interface Item

    • Method Detail

      • getStringValue

        java.lang.String getStringValue()
        Get the value of the item as a string. For nodes, this is the string value of the node as defined in the XPath 2.0 data model, except that all nodes are treated as being untyped: it is not an error to get the string value of a node with a complex type. For atomic values, the method returns the result of casting the atomic value to a string.

        If the calling code can handle any CharSequence, the method getStringValueCS() should be used. If the caller requires a string, this method is preferred.

        Specified by:
        getStringValue in interface ValueRepresentation
        Returns:
        the string value of the item
        Since:
        8.4
        See Also:
        getStringValueCS()
      • getStringValueCS

        java.lang.CharSequence getStringValueCS()
        Get the string value of the item as a CharSequence. This is in some cases more efficient than the version of the method that returns a String. The method satisfies the rule that X.getStringValueCS().toString() returns a string that is equal to X.getStringValue().

        Note that two CharSequence values of different types should not be compared using equals(), and for the same reason they should not be used as a key in a hash table.

        If the calling code can handle any CharSequence, this method should be used. If the caller requires a string, the getStringValue() method is preferred.

        Specified by:
        getStringValueCS in interface ValueRepresentation
        Returns:
        the string value of the item
        Since:
        8.4
        See Also:
        getStringValue()
      • getTypedValue

        SequenceIterator getTypedValue()
                                throws XPathException
        Get the typed value of the item.

        For a node, this is the typed value as defined in the XPath 2.0 data model. Since a node may have a list-valued data type, the typed value is in general a sequence, and it is returned in the form of a SequenceIterator.

        If the node has not been validated against a schema, the typed value will be the same as the string value, either as an instance of xs:string or as an instance of xs:untypedAtomic, depending on the node kind.

        For an atomic value, this method returns an iterator over a singleton sequence containing the atomic value itself.

        Returns:
        an iterator over the items in the typed value of the node or atomic value. The items returned by this iterator will always be atomic values.
        Throws:
        XPathException - where no typed value is available, for example in the case of an element with complex content
        Since:
        8.4