org.apache.jena.sparql.function.library

Class collation

java.lang.Object

org.apache.jena.sparql.function.FunctionBase

org.apache.jena.sparql.function.FunctionBase2

org.apache.jena.sparql.function.library.collation

All Implemented Interfaces:

Function

public class collation
extends FunctionBase2

Access to a NodeValue which is a collection (NodeValueSortKey). See FN_CollationKey for the Functions and Operators function. This function takes two parameters. First is the collation (a string), second the NodeValue result of an Expr (ExprVar, ExprFunctionN, NodeValue, etc).

If called with a prefix afn, e.g. ORDER BY afn:collation("fi", ?label);. The first argument (in this case, "fi") is then resolved to a Locale, that is used to build a Collator. If a locale does not match any known collator, then a rule based collator (RuleBasedCollator) is returned, but with no rules, returning values in natural order, not applying any specific collation order.

The second argument, which is an Expr, will have its literal string value extracted (or will raise an error if it is not possible). This means that if the expr is a NodeValueLang (e.g. rendered from "Casa"@pt), the language tag will be discarded, and only the literal string value (i.e. Casa) will be taken into account for this function.

See Also:

NodeValueSortKey, FN_CollationKey

Constructor Summary

Constructors

Constructor and Description
collation()

Method Summary

Modifier and Type	Method and Description
NodeValue	exec(NodeValue v1, NodeValue v2)

Methods inherited from class org.apache.jena.sparql.function.FunctionBase2

checkBuild, exec

Methods inherited from class org.apache.jena.sparql.function.FunctionBase

build, evalArgs, exec

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

collation

public collation()

Method Detail

exec

public NodeValue exec(NodeValue v1,
                      NodeValue v2)

Specified by:

exec in class FunctionBase2