|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object com.saxonica.functions.map.SingletonMap
public class SingletonMap
A map containing a single entry
Field Summary |
---|
Fields inherited from interface net.sf.saxon.om.ValueRepresentation |
---|
EMPTY_VALUE_ARRAY |
Constructor Summary | |
---|---|
SingletonMap(AtomicValue key,
ValueRepresentation<? extends Item> value)
Construct the singleton map |
Method Summary | |
---|---|
FunctionItem |
curry(ValueRepresentation<? extends Item>[] value)
Curry a function by binding one or more (but not all) of its arguments |
boolean |
deepEquals(FunctionItem other,
XPathContext context,
GenericAtomicComparer comparer,
int flags)
Test whether this FunctionItem is deep-equal to another function item, under the rules of the deep-equal function |
ValueRepresentation<? extends Item> |
get(AtomicValue key,
XPathContext context)
Get an entry from the Map. |
int |
getArity()
Get the arity of the function |
StringCollator |
getCollation()
Get the collation of the map |
String |
getCollationName()
Get the name of the collation of the map |
FunctionItemType |
getFunctionItemType(TypeHierarchy th)
Get the item type of the function item |
StructuredQName |
getFunctionName()
Get the name of the function, or null if it is anonymous |
AtomicType |
getKeyType(TypeHierarchy th)
Get the lowest common item type of the keys in the map |
int |
getLength()
Get the size of the value (the number of items) |
String |
getStringValue()
Get the value of the item as a string. |
CharSequence |
getStringValueCS()
Get the string value of the item as a CharSequence. |
SequenceIterator<? extends AtomicValue> |
getTypedValue()
Get the typed value of the item. |
SequenceType |
getValueType(TypeHierarchy th)
Get the lowest common sequence type of all the values in the map |
SequenceIterator<? extends Item> |
invoke(SequenceIterator<? extends Item>[] args,
XPathContext context)
Invoke the function |
boolean |
isEmpty()
Ask whether the map is empty |
MapItem |
itemAt(int n)
Get the n'th item in the value, counting from 0 |
UnfailingIterator<AtomicValue> |
keys()
Get the set of all key values in the map. |
MapItem |
remove(AtomicValue key,
XPathContext context)
Remove an entry from the map |
void |
setCollation(String collationName,
StringCollator collation)
Set the collation of the map |
int |
size()
Get the size of the map |
GroundedValue<MapItem> |
subsequence(int start,
int length)
Get a subsequence of the value |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
---|
public SingletonMap(AtomicValue key, ValueRepresentation<? extends Item> value)
key
- the keyvalue
- the valueMethod Detail |
---|
public int getLength()
getLength
in interface GroundedValue<MapItem>
public void setCollation(String collationName, StringCollator collation)
collationName
- the name of the collation to be used by this mapcollation
- the corresponding collation objectpublic StringCollator getCollation()
getCollation
in interface MapItem
public String getCollationName()
getCollationName
in interface MapItem
public ValueRepresentation<? extends Item> get(AtomicValue key, XPathContext context) throws XPathException
get
in interface MapItem
key
- the value of the keycontext
- the XPath dynamic evaluation context
XPathException
- if a dynamic error occurspublic MapItem remove(AtomicValue key, XPathContext context) throws XPathException
remove
in interface MapItem
key
- the key of the entry to be removedcontext
- the XPath dynamic context
XPathException
- if a dynamic error occurspublic int size()
size
in interface MapItem
public boolean isEmpty()
isEmpty
in interface MapItem
public UnfailingIterator<AtomicValue> keys()
keys
in interface MapItem
public AtomicType getKeyType(TypeHierarchy th)
getKeyType
in interface MapItem
th
- the type hierarchy
public SequenceType getValueType(TypeHierarchy th)
getValueType
in interface MapItem
th
- the type hierarchy
public FunctionItemType getFunctionItemType(TypeHierarchy th)
getFunctionItemType
in interface FunctionItem<MapItem>
th
- the type hierarchy cache. If null is supplied, the resulting item type may be less precise.
public StructuredQName getFunctionName()
getFunctionName
in interface FunctionItem<MapItem>
public int getArity()
getArity
in interface FunctionItem<MapItem>
public SequenceIterator<? extends Item> invoke(SequenceIterator<? extends Item>[] args, XPathContext context) throws XPathException
invoke
in interface FunctionItem<MapItem>
args
- the actual arguments to be suppliedcontext
- the XPath dynamic evaluation context
XPathException
- if a dynamic error occurspublic FunctionItem curry(ValueRepresentation<? extends Item>[] value) throws XPathException
curry
in interface FunctionItem<MapItem>
value
- the values to which the arguments are to be bound
XPathException
- if any dynamic error occurspublic String getStringValue()
getStringValueCS()
should
be used. If the caller requires a string, this method is preferred.
getStringValue
in interface Item<MapItem>
getStringValue
in interface ValueRepresentation<MapItem>
UnsupportedOperationException
- if the item is a function item (an unchecked exception
is used here to avoid introducing exception handling to a large number of paths where it is not
needed)getStringValueCS()
public CharSequence getStringValueCS()
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.
getStringValueCS
in interface Item<MapItem>
getStringValueCS
in interface ValueRepresentation<MapItem>
UnsupportedOperationException
- if the item is a function item (an unchecked exception
is used here to avoid introducing exception handling to a large number of paths where it is not
needed)getStringValue()
public SequenceIterator<? extends AtomicValue> getTypedValue() throws XPathException
getTypedValue
in interface Item<MapItem>
XPathException
- where no typed value is available, for example in the case of
an element with complex contentpublic boolean deepEquals(FunctionItem other, XPathContext context, GenericAtomicComparer comparer, int flags) throws XPathException
deepEquals
in interface FunctionItem<MapItem>
other
- the other function itemcontext
- the dynamic evaluation contextcomparer
- the object to perform the comparisonflags
- options for how the comparison is performed
XPathException
- if the comparison cannot be performedpublic MapItem itemAt(int n)
GroundedValue
itemAt
in interface GroundedValue<MapItem>
n
- the index of the required item, with 0 representing the first item in the sequence
public GroundedValue<MapItem> subsequence(int start, int length)
GroundedValue
subsequence
in interface GroundedValue<MapItem>
start
- the index of the first item to be included in the result, counting from zero.
A negative value is taken as zero. If the value is beyond the end of the sequence, an empty
sequence is returnedlength
- the number of items to be included in the result. Specify Integer.MAX_VALUE to
get the subsequence up to the end of the base sequence. If the value is negative, an empty sequence
is returned. If the value goes off the end of the sequence, the result returns items up to the end
of the sequence
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |