|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object net.sf.saxon.value.Value<AtomicValue> net.sf.saxon.value.AtomicValue net.sf.saxon.value.StringValue
public class StringValue
An atomic value of type xs:string. This class is also used for types derived from xs:string. Subclasses of StringValue are used for xs:untypedAtomic and xs:anyURI values.
Nested Class Summary | |
---|---|
class |
StringValue.CharacterIterator
CharacterIterator is used to iterate over the characters in a string, returning them as integers representing the Unicode code-point. |
Field Summary | |
---|---|
static StringValue |
EMPTY_STRING
|
static StringValue |
FALSE
|
protected boolean |
noSurrogates
|
static StringValue |
SINGLE_SPACE
|
static StringValue |
TRUE
|
protected CharSequence |
value
|
Fields inherited from class net.sf.saxon.value.AtomicValue |
---|
typeLabel |
Fields inherited from class net.sf.saxon.value.Value |
---|
INDETERMINATE_ORDERING |
Fields inherited from interface net.sf.saxon.om.ValueRepresentation |
---|
EMPTY_VALUE_ARRAY |
Constructor Summary | |
---|---|
protected |
StringValue()
Protected constructor for use by subtypes |
|
StringValue(CharSequence value)
Constructor. |
|
StringValue(CharSequence value,
AtomicType typeLabel)
Constructor. |
Method Summary | |
---|---|
boolean |
codepointEquals(StringValue other)
Test whether this StringValue is equal to another under the rules of the codepoint collation |
boolean |
containsSurrogatePairs()
Determine whether the string contains surrogate pairs |
static CharSequence |
contract(int[] codes,
int used)
Contract an array of integers containing Unicode codepoints into a Java string |
AtomicValue |
copyAsSubType(AtomicType typeLabel)
Create a copy of this atomic value, with a different type label |
static String |
diagnosticDisplay(String s)
Produce a diagnostic representation of the contents of the string |
boolean |
effectiveBooleanValue()
Get the effective boolean value of a string |
boolean |
equals(Object other)
Determine if two AtomicValues are equal, according to XPath rules. |
int[] |
expand()
Expand a string containing surrogate pairs into an array of 32-bit characters |
static int[] |
expand(CharSequence s)
Expand a string containing surrogate pairs into an array of 32-bit characters |
CharSequence |
getPrimitiveStringValue()
Get the string value as a CharSequence |
BuiltInAtomicType |
getPrimitiveType()
Determine the primitive type of the value. |
Comparable |
getSchemaComparable()
Get a Comparable value that implements the XML Schema comparison semantics for this value. |
int |
getStringLength()
Get the length of this string, as defined in XPath. |
static int |
getStringLength(CharSequence s)
Get the length of a string, as defined in XPath. |
Object |
getXPathComparable(boolean ordered,
StringCollator collator,
XPathContext context)
Get an object value that implements the XPath equality and ordering comparison semantics for this value. |
int |
hashCode()
|
boolean |
isIdentical(Value v)
Determine whether two atomic values are identical, as determined by XML Schema rules. |
boolean |
isKnownToContainNoSurrogates()
Ask whether the string is known to contain no surrogate pairs. |
boolean |
isZeroLength()
Determine whether the string is a zero-length string. |
UnfailingIterator |
iterateCharacters()
Iterate over a string, returning a sequence of integers representing the Unicode code-point values |
static StringValue |
makeStringValue(CharSequence value)
Factory method. |
void |
setContainsNoSurrogates()
Assert that the string is known to contain no surrogate pairs |
void |
setStringValueCS(CharSequence value)
Set the value of the item as a CharSequence. |
String |
toString()
Get string value. |
Methods inherited from class net.sf.saxon.value.AtomicValue |
---|
asAtomic, checkPermittedContents, getCardinality, getComponent, getItemType, getLength, getStringValue, getStringValueCS, getTypedValue, getTypeLabel, isNaN, itemAt, iterate, process, setTypeLabel, subsequence |
Methods inherited from class net.sf.saxon.value.Value |
---|
asItem, asItem, asIterator, asValue, convertToJava, fromItem, getCanonicalLexicalRepresentation, getIterator, getSequenceLength, reduce |
Methods inherited from class java.lang.Object |
---|
clone, finalize, getClass, notify, notifyAll, wait, wait, wait |
Field Detail |
---|
public static final StringValue EMPTY_STRING
public static final StringValue SINGLE_SPACE
public static final StringValue TRUE
public static final StringValue FALSE
protected CharSequence value
protected boolean noSurrogates
Constructor Detail |
---|
protected StringValue()
public StringValue(CharSequence value)
value
- the String value. Null is taken as equivalent to "".public StringValue(CharSequence value, AtomicType typeLabel)
value
- the String value.typeLabel
- the type of the value to be created. The caller must ensure that this is
a type derived from string and that the string is valid against this type.Method Detail |
---|
public void setContainsNoSurrogates()
public AtomicValue copyAsSubType(AtomicType typeLabel)
copyAsSubType
in class AtomicValue
typeLabel
- the type label of the new copy. The caller is responsible for checking that
the value actually conforms to this type.
public BuiltInAtomicType getPrimitiveType()
getPrimitiveType
in class AtomicValue
public static StringValue makeStringValue(CharSequence value)
value
- the String value. Null is taken as equivalent to "".
public final CharSequence getPrimitiveStringValue()
getPrimitiveStringValue
in class AtomicValue
public final void setStringValueCS(CharSequence value)
For system use only. In principle, a StringValue is immutable. However, in special circumstances, if it is newly constructed, the content can be changed to reflect the effect of the whiteSpace facet.
value
- the value of the stringpublic int getStringLength()
public static int getStringLength(CharSequence s)
s
- The string whose length is required
public boolean isZeroLength()
public boolean containsSurrogatePairs()
public boolean isKnownToContainNoSurrogates()
public UnfailingIterator iterateCharacters()
public int[] expand()
public static int[] expand(CharSequence s)
s
- the string to be expanded
public static CharSequence contract(int[] codes, int used)
codes
- an array of integers representing the Unicode code pointsused
- the number of items in the array that are actually used
public Object getXPathComparable(boolean ordered, StringCollator collator, XPathContext context)
getXPathComparable
in class AtomicValue
ordered
- true if an ordered comparison is required. In this case the result is null if the
type is unordered; in other cases the returned value will be a Comparable.collator
- Collation to be used for comparing stringscontext
- the XPath dynamic evaluation context, used in cases where the comparison is context
sensitive
public boolean equals(Object other)
equals
in class AtomicValue
other
- the other value
ClassCastException
- alwayspublic int hashCode()
hashCode
in class Value<AtomicValue>
public boolean codepointEquals(StringValue other)
other
- the value to be compared with this value
public boolean effectiveBooleanValue()
effectiveBooleanValue
in class AtomicValue
public String toString()
AtomicValue
toString
in class AtomicValue
public Comparable getSchemaComparable()
getSchemaComparable
in class AtomicValue
public boolean isIdentical(Value v)
Note that even this check ignores the type annotation of the value. The integer 3 and the short 3 are considered identical, even though they are not fully interchangeable. "Identical" means the same point in the value space, regardless of type annotation.
NaN is identical to itself.
isIdentical
in class AtomicValue
v
- the other value to be compared with this one
public static String diagnosticDisplay(String s)
s
- the string
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |