Prev Class | Next Class | Frames | No Frames |
Summary: Nested | Field | Method | Constr | Detail: Nested | Field | Method | Constr |
public interface Item
extends ValueRepresentation, PullEvent
Fields inherited from interface net.sf.saxon.om.ValueRepresentation | |
EMPTY_VALUE_ARRAY |
Method Summary | |
String |
|
CharSequence |
|
SequenceIterator |
|
Methods inherited from interface net.sf.saxon.om.ValueRepresentation | |
getStringValue , getStringValueCS |
public 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 methodgetStringValueCS()
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()
public 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 thatX.getStringValueCS().toString()
returns a string that is equal toX.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, thegetStringValue()
method is preferred.
- Specified by:
- getStringValueCS in interface ValueRepresentation
- Returns:
- the string value of the item
- Since:
- 8.4
- See Also:
getStringValue()
public 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