xs:anyType

Represents the most generic data type. All data types including anyAttribute, anyElement, anySimpleType, anyValue, as well as sequences, items, nodes, strings, decimals.

xsext:anyValue

A subset of xs:anyType including dateTime, boolean, string, numeric values, or any single value. Does not include anyAttribute, anyElement, item, node, sequence, or anySimpleType.

xs:boolean

A subset of xsext:anyValue. A value that supports the mathematical concept of binary-valued logic: true or false.

xs:byte

A subset of xs:short. A sequence of decimal digits (0-9) with a range of 127 to -128. If the sign is omitted, plus  (+) is assumed.

Examples: -1, 0, 126, +100

xs:date

A subset of xsext:anyValue. Represents the leftmost component of dateTime YYYY-MM-DD where:

May be preceded by a leading minus  (-) sign to indicate a negative number. If the sign is omitted, plus  (+) is assumed.

May be immediately followed by a Z to indicate Coordinated Universal Time (UTC) or, to indicate the time zone (the difference between the local time and Coordinated Universal Time), immediately followed by a sign, + or -, followed by the difference from UTC represented as hh:mm.

Example:

To specify 1:20 pm on May the 31st, 1999, write: 1999-05-31.

xs:dateTime

A subset of xsext:anyValue. Represents the format YYYY-MM-DDThh:mm:ss where:

May be preceded by a leading minus  (-) sign to indicate a negative number. If the sign is omitted, plus  (+) is assumed. Additional digits can be used to increase the precision of fractional seconds if desired (ss.ss...) with any number of digits after the decimal point is supported.

May be immediately followed by a Z to indicate Coordinated Universal Time (UTC) or, to indicate the time zone (the difference between the local time and Coordinated Universal Time), immediately followed by a sign, + or -, followed by the difference from UTC represented as hh:mm.

Example:

To specify 1:20 pm on May the 31st, 1999 EST, which is five hours behind Coordinated Universal Time (UTC), write: 1999-05-31T13:20:00-05:00.

xs:decimal

A subset of xsext:anyValue. Includes all integer types, such as xs:integer, xs:long, xs:short, xs:int, or xs:byte.

Represents a finite-length sequence of decimal digits (0-9) separated by an optional period as a decimal indicator. An optional leading sign is allowed. If the sign is omitted, plus  (+) is assumed. Leading and trailing zeroes are optional. If the fractional part is zero, the period and following zeroes can be omitted.

Examples: -1.23, 12678967.543233, +100000.00, 210

xs:double

A subset of xsext:anyValue. There are no subordinate data types; however, xs:float and xs:decimal, and all derived types, can be promoted to xs:double in certain cases, such as function calls.

Represents a double precision 64-bit floating point value. Supports the special values positive and negative zero, positive and negative infinity and not-a-number (0, -0, INF, -INF and NaN).

xs:float

A subset of xsext:anyValue. There are no subordinate data types; however, xs:decimal, and all derived types, can be promoted to xs:float in certain cases, such as function calls.

Represents a single-precision 32-bit floating point value. Supports the special values positive and negative zero, positive and negative infinity and not-a-number (0, -0, INF, -INF and NaN).

xsext:item

A subset of xs:anyType. Includes xsext:anyValue and xsext:node. Excludes any sequence. Represents a list element, individual value, or attribute.

xs:int

A subset of xs:long. Represents a finite-length sequence of decimal digits (0-9). An optional leading sign is allowed. If the sign is omitted, plus  (+) is assumed.

Examples: -1, 0, 12678967543233, +100000

xs:integer

A subset of xs:decimal. Represents a finite-length sequence of decimal digits (0-9). An optional leading sign is allowed. If the sign is omitted, plus  (+) is assumed.

Examples: -1, 0, 12678967543233, +100000

xs:long

A subset of xs:decimal. A sequence of decimal digits (0-9) with a range of 9223372036854775807 to -9223372036854775808. If the sign is omitted, plus  (+) is assumed.

Examples: -1, 0, 12678967543233, +100000

xsext:node

A subset of xsext:anyValue. A component in a tree structure that represents a data element.

xs:short

A subset of xs:int. A sequence of decimal digits (0-9) with a range of 32767 to -32768. If the sign is omitted, plus  (+) is assumed.

Examples: -1, 0, 12678, +10000

xs:string

A subset of xsext:anyValue. A sequence that contains alphabetic, numeric, or special characters.

xs:time

A subset of xsext:anyValue. Represents the rightmost segment of the dateTime format where:

May contain an optional following time zone indicator.

Examples:

xf:data

Data Type:

Description: Returns the typed-value of each input node.

Examples:

Notes:

If the source value is not a node, the function returns an error.

XQuery Specification Compliance:

xf:avg

Data Type:

Description: Returns the average of a sequence of numbers.

Examples:

Notes:

If the source value contains nodes, the value of each node is extracted using the xf:data function. If an empty list occurs, it is discarded.

If the source value contains only numbers, the Avg function returns the average of the numbers, which is the sum of the source sequence divided by the count of the source sequence.

If the source value is an empty list, the function returns an empty list.

If the source value contains non-numeric data, the function returns an error.

XQuery Specification Compliance:

Liquid Data requires a list of double precision values instead of a list of items.

xf:count

Data Type:

Description:

Returns the number of items in the sequence in an unsigned integer.

Examples:

Notes:

If the source value is an empty list, the function returns an empty list.

XQuery Specification Compliance:

Liquid Data returns an integer value (xs:integer) instead of an unsigned int (xs:unsignedInt) value.

xf:max

Data Type:

Description:

Returns the maximum value from a sequence. If there are two or more items with the same value, the specific item whose value is returned is implementation-dependent.

Examples:

xf:max((3, 10)) returns the value 10.

xf:max((<a>{4}</a>, 3, (), <b >{2}</b>)) returns <a>{4}</a>.

Notes:

If the source value contains nodes, the value of each node is extracted using the xf:data function. If an empty list occurs, it is discarded.

All values in the list must be instances of one of the following types:

For example, if the list contains items with typed values that represent both decimal values and dates, an error will occur.

The values in the sequence must have a total order:

Both of these conditions must be true; otherwise, the function returns an error.

XQuery Specification Compliance:

xf:min

Data Type:

Description:

Returns the minimum value from a sequence of numbers. If there are two or more items with the same value, the specific item whose value is returned is implementation-dependent.

Examples:

Notes:

If the source value contains nodes, the value of each node is extracted using the Data function. If an empty list occurs, it is discarded.

After extracting the values from nodes, the sequence must contain only values of a single type.

The values in the sequence must have a total order:

Both of these conditions must be true; otherwise, the function returns an error.

XQuery Specification Compliance:

xf:sum

Data Type:

Description:

Returns the sum of a sequence of numbers.

Examples:

Notes:

If the source value contains nodes, the value of each node is extracted using the Data function. If an empty list occurs, it is discarded.

If the source value contains only numbers, the Sum function returns the sum of the numbers.

If the source value contains non-numeric data, the function returns an error.

If the input sequence is empty, the function returns an empty list.

XQuery Specification Compliance:

xf:false

Data Types:

Description:

Returns the boolean value false.

Examples:

XQuery Specification Compliance:

Conforms to the current specification.

xf:not

Data Types:

Description:

Returns true if the value of the source value is false and false if the value of the source value is true.

Examples:

XQuery Specification Compliance:

xf:true

Data Types:

Description:

Returns the boolean value true.

Examples:

XQuery Specification Compliance:

Conforms to the current specification.

xf:boolean-from-string

Data Types:

Description:

Returns a boolean value of true or false from the string source value.

Examples:

Notes:

If the input parameter is empty, the function returns an empty list. Otherwise, Liquid Data generates an error.

XQuery Specification Compliance:

xf:byte

Data Types:

Description:

Constructs a byte integer value from the string source value.

Examples:

Notes:

An error occurs if the source value is greater than 127 or less than -128.

Liquid Data truncates the input if it is a non-integer number.

If the number falls outside of the range of byte values, the number wraps.

If the number is an integer that falls within the range, the value is unchanged.

If the input is a string, Liquid Data tries to parse it into a byte value.

If the input is the boolean value true, the function returns 1. If it is false, it returns 0.

XQuery Specification Compliance:

xf:decimal

Data Types:

Input data type: xsext:anyValue?

Returned data type: xs:decimal?

Description:

Constructs a decimal value from the source value.

Examples:

XQuery Specification Compliance:

xf:double

Data Types:

Description:

Constructs a double precision value from the source value.

Examples:

XQuery Specification Compliance:

xf:float

Data Types:

Input data type: xsext:anyValue?

Returned data type: xs:float?

Description:

Constructs a floating point value from the source value.

Examples:

XQuery Specification Compliance:

xf:int

Data Types:

Input data type: xsext:anyValue?

Returned data type: xs:integer?

Description:

Constructs an integer value from the source value. The largest integer value is limited to a 32-bit expression.

Examples:

Notes:

An error occurs if the source value is greater than 2,147,483,647 or less than -2,147,483,648. To the Liquid Data Server, the xf:int function is exactly the same as the xf:integer function.

XQuery Specification Compliance:

xf:integer

Data Types:

Input data type: xsext:anyValue?

Returned data type: xs:integer?

Description:

Constructs an integer value from the source value. The largest integer value is limited to a 32-bit expression.

Examples:

Notes:

An error occurs if the source value is greater than 2,147,483,647 or less than -2,147,483,648. To the Liquid Data Server, the xf:integer function is exactly the same as the xf:int function.

XQuery Specification Compliance:

xf:long

Data Types:

Description:

Constructs a four-byte integer value from the source value. Use a long integer data type when the value exceeds the limitations imposed by other integer data types.

Examples:

Notes:

An error occurs if the source value is greater than 9,223,372,036,854,775,807 or less than -9,223,372,036,854,775,808.

XQuery Specification Compliance:

xf:short

Data Types:

Input data type: xsext:anyValue?

Returned data type: xs:short?

Description:

Constructs a two-byte integer value from the source value. The largest short integer value is limited to a 16-bit expression.

Examples:

Notes:

An error occurs if the source value is greater than 32,767 or less than -32,768.

XQuery Specification Compliance:

xf:string

Data Types:

Description:

Constructs a string value from the source value. The source value can be a sequence, a node of any kind, or a simple value.

Examples:

Notes:

Liquid Data accepts any simple value, but supports no other accessor types, such as a sequence or other type of node.

XQuery Specification Compliance:

G

Era

AD

y

Year

1996

M

Month of year

July, 07

d

Day of the month

19

h

Hour of the day (1-12)

10

H

Hour of the day (0-23)

22

m

Minute of the hour

30

s

Second of the minute

55

S

Millisecond

978

E

Day of the week

Tuesday

D

Day of the year

27

w

Week in the year

27

W

Week in the month

2

a

am/pm marker

AM, PM

k

Hour of the day (1-24)

24

K

Hour of the day (0-11)

0

z

Time zone

Pacific Standard Time

Pacific Daylight Time

xf:local-name

Data Types:

Description:

Returns a string value that corresponds to the local name of the specified node.

Examples:

XQuery Specification Compliance:

xf:ceiling

Data Types:

Description:

Returns the smallest (closest to negative infinity) integer that is not smaller than the source value.

Examples:

Notes:

If the argument is an empty list, the function returns an empty list.

XQuery Specification Compliance:

Conforms to the current specification.

xf:floor

Data Types:

Description:

Returns the largest (closest to positive infinity) integer that is not greater than the source value.

Examples:

Notes:

If the argument is an empty list, the function returns an empty list.

XQuery Specification Compliance:

Conforms to the current specification.

xf:round

Data Types:

Description:

Returns the integer that is closest to the source value.

Examples:

Notes:

Round(x) produces the same result as the Floor function(x+0.5). If there are two such numbers, returns the one that is closest to +INF.

If the argument is +INF, returns +INF.

If the argument is -INF, returns -INF.

If the argument is +0, returns +0.

If the source value is an empty list, the function returns an empty list.

XQuery Specification Compliance:

Liquid Data does not support not-a-number (NaN) or -0.

* (Multiply)

Data Types:

Description:

Returns the arithmetic product of the operands: ($operand1*$operand2).

Examples:

Notes:

This is a numeric operator that you can use as if it were a function to compute numeric results.

The operator accepts two numeric values as parameters, computes their product, and returns the result.

Liquid Data applies the following rules:

XQuery Specification Compliance:

+ (Add)

Data Types:

Description:

Returns the arithmetic sum of the operands: ($operand1+$operand2).

Examples:

Notes:

This is a numeric operator that you can use as if it were a function to compute numeric results.

The operator accepts two numeric values as parameters, computes their sum, and returns the result.

Liquid Data applies the following rules:

XQuery Specification Compliance:

-(Subtract)

Data Types:

Description:

Returns the arithmetic difference of the operands: ($operand1-$operand2).

Examples:

Notes:

This is a numeric operator that you can use as if it were a function to compute numeric results.

Liquid Data applies the following rules:

XQuery Specification Compliance:

and

Data Types:

Description:

The result is true if both values are true, and false if one of the values is false.

Examples:

Notes:

This is a boolean operator that you can use as a function to return a true or false result.

The arguments and return type are all boolean.

The following table shows how Liquid Data determines the result. The leftmost column contains the possible values of the first parameter; the top row contains the possible values of the second parameter.

div(ide)

Data Types:

Description:

Returns the arithmetic quotient of the operands ($operand1/$operand2).

Examples:

Notes:

This is a numeric operator that you can use as if it were a function to compute numeric results.

Liquid Data applies the following rules:

XQuery Specification Compliance:

eq

Data Types:

Description:

Returns true if Parameter1 is exactly equal to Parameter2.

Examples:

Notes:

This is a comparison operator that you can use as a function to compare operands.

If either operand is a node, Liquid Data extracts its typed value first, then performs a type check to ensure that the type of one operand is promotable to the other type; otherwise Liquid Data generates an error.

If either operand is an empty list, the function returns an empty list.

XQuery Specification Compliance:

ge

Data Types:

Description:

Returns true if Parameter1 is greater than or equal to Parameter2.

Examples:

See the examples for "eq" operator (previous entry in this table).

Notes:

This is a comparison operator that you can use as a function to compare operands.

If either operand is a node, Liquid Data extracts its typed value first, then performs a type check to ensure that the type of one operand is promotable to the other type; otherwise Liquid Data generates an error.

If either operand is an empty list, the function returns an empty list.

XQuery Specification Compliance:

gt

Data Types:

Description:

Returns true if Parameter1 is greater than Parameter2.

Examples:

See the examples for the "eq" operator (previous entry in this table).

Notes:

This is a comparison operator that you can use as a function to compare operands.

If either operand is a node, Liquid Data extracts its typed value first, then performs a type check to ensure that the type of one operand is promotable to the other type; otherwise Liquid Data generates an error.

If either operand is an empty list, the function returns an empty list.

XQuery Specification Compliance:

Liquid Data does not cast xs:anySimpleType to any other supported type.

Liquid Data does not support these data types: xs:yearMonthDuration, xs:dayTimeDuration, gregorian, xs:hexBinary, xs:base64Binary, xs:anyURI, xs:QName, or xs:NOTATION values.

le

Data Types:

Description:

Returns true if Parameter1 is less than or equal to Parameter2.

Examples:

See the examples for the "eq" operator (previous entry in this table).

Notes:

This is a comparison operator that you can use as a function to compare operands.

If either operand is a node, Liquid Data extracts its typed value first, then performs a type check to ensure that the type of one operand is promotable to the other type; otherwise Liquid Data generates an error.

If either operand is an empty list, the function returns an empty list.

XQuery Specification Compliance:

Liquid Data does not cast xs:anySimpleType to any other supported type.

Liquid Data does not support these data types: xs:yearMonthDuration, xs:dayTimeDuration, gregorian, xs:hexBinary, xs:base64Binary, xs:anyURI, xs:QName, or xs:NOTATION values.

lt

Data Types:

Description:

Returns true if Parameter1 is less than or equal to Parameter2.

Examples:

See the examples for the "eq" operator (previous entry in this table).

Notes:

This is a comparison operator that you can use as a function to compare operands.

If either operand is a node, Liquid Data extracts its typed value first, then performs a type check to ensure that the type of one operand is promotable to the other type; otherwise Liquid Data generates an error.

If either operand is an empty list, the function returns an empty list.

XQuery Specification Compliance:

Liquid Data does not cast xs:anySimpleType to any other supported type.

Liquid Data does not support these data types: xs:yearMonthDuration, xs:dayTimeDuration, gregorian, xs:hexBinary, xs:base64Binary, xs:anyURI, xs:QName, or xs:NOTATION values.

mod

Data Types:

Description:

Returns the remainder after dividing the first operand by the second operand:
($operand1 mod $operand2).

Examples:

Notes:

This is a numeric operator that you can use as if it were a function to compute numeric results.

Liquid Data applies the following rules:

XQuery Specification Compliance:

Liquid Data does not support not-a-number (NaN), -0, or the negative and positive infinity values -INF and INF.

ne

Data Types:

Description:

The result is false if both values are false and true if at least one of the values is true. Parameter2 is not evaluated if Parameter1 evaluates to true.

Examples:

See the examples for the "eq" operator (previous entry in this table).

Notes:

This is a boolean operator that you can use as a function to return a true or false result. It is not a standard XQuery operator, but necessary to complete certain comparative expressions in Liquid Data.

The arguments and return type are all boolean.

If either operand is a node, Liquid Data extracts its typed value first, then performs a type check to ensure that the type of one operand is promotable to the other type; otherwise Liquid Data generates an error.

If either operand is an empty list, the function returns an empty list.

XQuery Specification Compliance:

Liquid Data does not support these data types: xs:yearMonthDuration, xs:dayTimeDuration, gregorian, xs:hexBinary, xs:base64Binary, xs:anyURI, xs:QName, or xs:NOTATION values.

or

Data Types:

Description:

The result is false if both values are false and true if at least one of the values is true. Parameter2 is not evaluated if Parameter1 is true.

Examples:

Notes:

This is a boolean operator that you can use as a function to return a true or false result.

The arguments and return type are all boolean.

The following table shows how Liquid Data determines the result. The leftmost column contains the possible values of the first parameter; the top row contains the possible values of the second parameter

XQuery Specification Compliance:

xfext:if-then-else

Data Types:

Description:

The xfext:if-then-else function accepts the value of a boolean parameter to select one of two other input parameters.

Examples:

Notes:

Liquid Data examines the value of the first parameter. If the condition is true, Liquid Data returns the value of the second parameter (then). If the condition is false, Liquid Data returns the value of the third parameter (else). If the returned condition is not a boolean value, Liquid Data generates an error.

XQuery Specification Compliance:

This is an extended function. Liquid Data converts it to an XQuery if-then-else expression.

Function: xf:distinct-values

Data Types:

Description:

If the source value contains only nodes, the function removes duplicates and returns a subset of unique values.

Examples:

Notes:

The Liquid Data xf:distinct-values function varies from the standard XQuery function by removing duplicates from the result.

If the source value is an empty list, the function returns an empty list.

XQuery Specification Compliance:

Function: xf:empty

Data Types:

Description:

Returns true if the specified list of items is empty; otherwise, returns false.

Examples:

XQuery Specification Compliance:

Liquid Data supports an optional boolean returned value.

Function: xfext:subsequence

Format  1 Data Types:

Parameter1 data type: xsext:item*

Parameter2 data type: xs:integer

Returned data type: xsext:item*

Format  2 Data Types:

Parameter1 data type: xsext:item*

Parameter2 data type: xs:integer

Parameter3 data type: xs:integer

Returned data type: xsext:item*

Description:

Format 1: Returns the contiguous sequence of items described by Parameter 1 beginning at the position indicated by the Parameter 2 and continuing until the end of the sequence.

Format 2: Returns the contiguous sequence of items described by Parameter 1 beginning at the position indicated by the Parameter 2 and continuing for the number of items indicated by the value of Parameter 3.

Examples:

Notes:

Format 1: The first item of a sequence is located at position 1, not position 0.

If you omit the length parameter, the function returns all items up to the end of the source sequence.

If the starting location is greater than the number of items in the sequence, the function returns an empty list.

If the item list is empty, Liquid Data returns an empty list.

Format 2: The value of Parameter 2 can be greater than the number of items in the value of Parameter  1, in which case the subsequence includes items to the end of Parameter 3.

If the sum of the starting location and the length parameter is greater than the length of the source sequence, the function returns all items up to the end of the sequence.

The first item of a sequence is located at position 1, not position 0.

If the starting location is greater than the number of items in the sequence, the function returns an empty list.

If the item list is an empty list, Liquid Data returns an empty list.

Liquid Data is able to process either format of xf:subsequence. Adding a third parameter automatically invokes Format 2.

XQuery Specification Compliance:

Function: xf:compare

Data Types:

Description:

Returns -1, 0, or 1, depending on whether the value of Parameter1 is less than (-1), equal to (0), or greater than (1)the value of Parameter2.

Examples:

Notes:

If either argument is an empty list, the result is an empty list.

Liquid Data generates an error if either parameter is not a string.

XQuery Specification Compliance:

Liquid Data does not support the xf:compare format that accepts collations.

Function: xf:concat

Data Types:

Parameter1 data type: xs:string?

Parameter2 data type: xs:string?

Returned data type: xs:string?

Description:

Returns a string that concatenates Parameter1 with Parameter2.

Examples:

Notes:

The result string may not reflect Unicode or other W3C normalization.

Returns an empty string if the function has no arguments. If any argument is an empty list, it is treated as an empty string.

Liquid Data generates an error if either parameter is not a string.

XQuery Specification Compliance:

Liquid Data does not support a variable number of parameters to be concatenated. Choose only two strings to concatenate with each operation.

Function: xf:contains

Data Types:

Parameter1 data type: xs:string?

Parameter2 data type: xs:string?

Returned data type: xs:boolean?

Description:

Returns a boolean value of true or false indicating whether Parameter1 contains a string that is equal to Parameter2 at the beginning, at the end, or anywhere within Parameter1.

Examples:

Notes:

If the value of Parameter2 is a zero-length string, the function returns true. If the value of Parameter1 is a zero-length string and the value of Parameter2 is not a zero-length string, the function returns false.

If the value of Parameter1 or Parameter2 is an empty list, the function returns an empty list.

Liquid Data generates an error if either parameter is not a string.

XQuery Specification Compliance:

Liquid Data does not support the xf:contains format that accepts collations.

Function: xf:ends-with

Data Types:

Description:

Returns a boolean value or true or false indicating whether Parameter1 ends with a string that is equal to Parameter2.

Examples:

Notes:

If Parameter2 is a zero-length string, then the function returns true. If Parameter1 is a zero-length string and Parameter2 is not a zero-length string, the function returns false.

If Parameter1 or Parameter2 is an empty list, the function returns an empty list.

Liquid Data generates an error if either parameter is not a string.

XQuery Specification Compliance:

Liquid Data does not support the xf:ends-with format that accepts collations.

Function: xf:lower-case

Data Types:

Description:

Returns the value of the input string after translating every uppercase letter to its corresponding lower-case value.

Examples:

Notes:

Every uppercase letter that does not have a lower-case corresponding value and every character that is not an uppercase letter appears in the output in its original form.

If the source value is an empty list, the function returns an empty list.

XQuery Specification Compliance:

Conforms to the current specification.

Function: xf:starts-with

Data Types:

Description:

Returns a boolean value or true or false indicating whether Parameter1 starts with a string that is equal to Parameter2.

Examples:

Notes:

If Parameter2 is a zero-length string, then the function returns true. If Parameter1 is a zero-length string and tParameter2 is not a zero-length string, the function returns false.

If Parameter1 or Parameter2 is an empty list, the function returns an empty list.

Liquid Data generates an error if either parameter is not a string.

XQuery Specification Compliance:

Liquid Data does not support the xf:ends-with format that accepts collations.

Function: xf:string-length

Data Types:

Description:

Returns an integer equal to the number of characters in the input source string.

Examples:

Notes:

If the source value is an empty list, the function returns an empty list.

Liquid Data generates an error if either parameter is not a string.

XQuery Specification Compliance:

Function: xf:substring

Format 1 Data Types:

Format 2 Data Types:

Description:

Format 1: Returns that part of the Parameter1 source string from the starting location specified by Parameter2.

Format 2: Returns that part of the Parameter1 source string from the starting location specified by Parameter2 and continuing for the number of characters equal to the length specified by Parameter3.

Notes:

Format 1

If the starting location is a negative value, or greater than the length of source string, an error occurs.

The first character of a string is located at position 1 (not position 0).

If Parameter1 or Parameter2 is an empty list, the function returns an empty list.

If you omit Parameter3, the function returns characters up to the end of the source string.

Liquid Data generates an error if Parameter1 is not a string or if the starting location is less than 1.

Format 2

If the starting location is a negative value, or greater than the length of the source string, an error occurs.

The first character of a string is located at position 1 (not position 0).

If you omit length, the substring identifies characters to the end of the source string.

If length exceeds the number of characters in the source string, the function identifies only characters until the end of the source string.

If Parameter1, Parameter2, or Parameter3 is an empty list, the function returns an empty list.

Liquid Data generates an error if Parameter1 is not a string or if the starting location is less than 1.

Liquid Data is able to process either format of xf:substring. Adding a third parameter automatically invokes Format 2.

XQuery Specification Compliance:

Function: xf:substring-after

Data Types:

Description:

Returns that part of the Parameter1 source string that follows the first occurrence of those characters specified in Parameter2.

Examples:

Notes:

If Parameter2 is a zero-length string, the function returns the value of Parameter1. If Parameter1 is a zero-length string and Parameter2 is a zero-length string, the function returns a zero-length string.

If Parameter1 does not contain a string that is equal to Parameter2, the function returns a zero-length string.

If Parameter1 or Parameter2 is an empty list, the function returns an empty list.

XQuery Specification Compliance:

Liquid Data does not support the xf:substring-after format that accepts collations.

Function: xf:substring-before

Data Types:

Description:

Returns that part of the Parameter1 source string that precedes the first occurrence of those characters specified in Parameter2.

Examples:

Notes:

If Parameter2 is a zero-length string, the function returns the value of Parameter1. If Parameter1 is a zero-length string and Parameter2 is a zero-length string, the function returns a zero-length string.

If Parameter1 does not contain a string that is equal to Parameter2, the function returns a zero-length string.

If Parameter1 or Parameter2 is an empty list, the function returns an empty list.

XQuery Specification Compliance:

Liquid Data does not support the xf:substring-before format that accepts collations.

Function: xf:extrim

Data Types:

Description:

Returns the value of the input string with leading and trailing white space removed from the string.

Examples:

Notes:

If the input string is an empty list, the function returns an empty list.

Liquid Data generates an error if the parameter is not a string.

XQuery Specification Compliance:

Function: xf:upper-case

Data Types:

Description:

Returns the value of the input string after translating every lower-case letter to its uppercase correspondent.

Notes:

Every lower-case letter that does not have an uppercase corresponding value and every character that is not a lower-case letter appears in the output in its original form.

If the source value is an empty list, the function returns an empty list.

Liquid Data generates an error if the parameter is not a string.

XQuery Specification Compliance:

Conforms to the current specification.

Examples:

xs:boolean

Data Types:

Converts the input to a boolean value (true or false).

If the input parameter is empty, the function returns an empty list. Otherwise, Liquid Data generates an error.

Examples:

Notes:

This function uses the xf:boolean-from-string function.

XQuery Specification Compliance:

xs:date

Data Types:

Description:

Converts the input to a date value.

Examples:

Notes:

This function uses the xf:date function.

The string must contain a date in one of these formats:

where YYYY represents the year, MM represents the month (as a number), DD represents the day, hh and mm represents the number of hours and minutes that the timezone differs from GMT (UTC). Z indicates that the date is in the GMT timezone.

If the string cannot be parsed into a date value, Liquid Data generates an error.

XQuery Specification Compliance:

Conforms to the current specification.

xs:dateTime

Data Types:

Description:

Converts the input to a dateTime value.

Examples:

Notes:

This function uses the xf:date function.

XQuery Specification Compliance:

Conforms to the current specification.

xs:decimal

Data Types:

Description:

Converts the input to a decimal value.

Examples:

Notes:

This function uses the xf:decimal function.

XQuery Specification Compliance:

xs:double

Data Types:

Description:

Converts the input to a double precision value.

Examples:

Notes:

This function uses the xf:double function.

XQuery Specification Compliance:

xs:float

Data Types:

Description:

Converts the input to a floating point value.

Examples:

Notes:

This function uses the xf:float function.

XQuery Specification Compliance:

Liquid Data does not support not-a-number (NaN), -0, or the negative and positive infinity values -INF and INF.

Liquid Data attempts to support any input value, instead of just string literals, and convert it at run time.

xs:string

Data Types:

Description:

Converts the input to a string value.

Examples:

Notes:

This function uses the xf:string function.

XQuery Specification Compliance:

xs:time

Data Types:

Description:

Converts the input to a time value.

Examples:

Notes:

This function uses the xf:time function.

XQuery Specification Compliance:

Conforms to the current specification.