Functions Reference

Table A-1 Data Types

Data Type Name	Description
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: YYYY is the year MM is the month DD is the day 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: YYYY is the year MM is the month DD is the day T is the date/time separator hh is the hour mm is the minute ss is the second 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: hh is the hour mm is the minute ss is the second May contain an optional following time zone indicator. Examples: To indicate 1:20 pm EST, which is five hours behind Coordinated Universal Time (UTC), write: 13:20:00-05:00. Midnight is 00:00:00.

Table A-2 Accessor Functions

Function Name	Data Type, Description, and Examples	Notes and XQuery Specification Compliance
xf:data	Data Type: Input data type: xsext:node? Returned data type: xsext:anyValue? Description: Returns the typed-value of each input node. Examples: xf:data(<a>{3}</a>) returns the numeric value 3. xf:data(<a/>) returns an empty list (). xf:data((<a>{3}</a>, <a>{7}</a>)) generates a compile-time error because the parameter is a list of nodes. xf:data(<date location="SD">2002-07-12</date>) returns the string value "2002-07-12.". xf:data(3) generates a compile-time error because 3 is not a node.	Notes: If the source value is not a node, the function returns an error. XQuery Specification Compliance: Liquid Data does not use a list of nodes; it uses only an optional node. Liquid Data does not generate an error when you specify a document node. It returns an empty list.

Function Name

Data Type, Description, and Examples

Notes and XQuery Specification Compliance

xf:data

Data Type:

Input data type: xsext:node?

Returned data type: xsext:anyValue?

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

Examples:

xf:data(<a>{3}</a>) returns the numeric value 3.

xf:data(<a/>) returns an empty list ().

xf:data((<a>{3}</a>, <a>{7}</a>)) generates a compile-time error because the parameter is a list of nodes.

xf:data(<date location="SD">2002-07-12</date>) returns the string value "2002-07-12.".

xf:data(3) generates a compile-time error because 3 is not a node.

Notes:

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

XQuery Specification Compliance:

Liquid Data does not use a list of nodes; it uses only an optional node.

Liquid Data does not generate an error when you specify a document node. It returns an empty list.

Table A-3 Aggregate Functions

Name	Data Type, Description, and Examples	Notes and XQuery Specification Compliance
xf:avg	Data Type: Input data type: xs:double* Returned data type: xs:double? Description: Returns the average of a sequence of numbers. Examples: xf:avg((4, 10)) returns the double precision floating point value 7.0. xf:avg((4, (), 10)) also returns the double precision floating point value 7.0. xf:avg((4, "10")) generates a compile-time error because the input sequence contains a string.	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: Input data type: xs:item* Returned data type: xs:integer Description: Returns the number of items in the sequence in an unsigned integer. Examples: xf:count((3, "10")) returns the integer value 2. xf:count(()) returns the integer value 0. xf:count((3, "10", (), )) returns the value 3 (the empty list is ignored).	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: Input data type: xsext:item* Returned data type: xsext:item? 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: numeric xs:string xs:date xs:time xs:dateTime 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: DateTime values must all contain a time zone or omit a time zone. Duration values must contain only years and months or contain only days, hours, minutes and seconds. Both of these conditions must be true; otherwise, the function returns an error. XQuery Specification Compliance: Liquid Data does not support a format with a collation literal. Liquid Data has no restrictions on date and time input values. Liquid Data supports a correct return type of xs:item? instead of xs:anySimpleType?, which is incorrect. Liquid Data supports only numeric, xs:string, xs:date, xs:time, and xs:dateTime data types.
xf:min	Data Type: Input data type: xsext:item* Returned data type: xsext:item? 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: xf:min((3, 10)) returns the value 3. xf:min((<a>{4}</a>, 3, (), <b>{2}</b>)) returns <b>{2}</b>. xf:min((3, 4, "2")) generates an error because the sequence contains both numeric and string values. xf:min(()) returns an empty list ().	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: DateTime values must all contain a time zone or omit a timezone Duration values must contain only years and months or contain only days, hours, minutes and seconds Both of these conditions must be true; otherwise, the function returns an error. XQuery Specification Compliance: Liquid Data does not support a format with a collation literal. Liquid Data has no restrictions on date and time input values. Liquid Data supports a correct return type of xs:item? instead of xs:anySimpleType?, which is incorrect. Liquid Data supports only numeric, xs:string, xs:date, xs:time, and xs:dateTime data types.
xf:sum	Data Type: Input data type: xsext:anyValue* Returned data type: xsext:anyValue? Description: Returns the sum of a sequence of numbers. Examples: xf:sum((3, 8, (), 1)) returns the value 12. xf:sum(()) returns an empty list (). xf:sum((<a>{4}</a>, 3)) returns a value of 7. xf:sum(("7", 3)) generates a compile-time error because the sequence that is passed in to the function is not homogenous.	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: Liquid Data adheres to the prior XQuery specification (December, 2001) by returning an empty list if the input sequence is empty. Liquid Data output depends on the input type. If the input type is xs:decimal, the returned value is xs:decimal; if the input type is xs:decimal and xs:float, the returned value is xs:float; if the input type is xs:double, the returned value is xs:double.

Table A-4 Boolean Functions

Function Name	Data Type, Description, and Examples	Notes and XQuery Compliance
xf:false	Data Types: Input data type: No input data required. Returned data type: xs:boolean Description: Returns the boolean value false. Examples: xf:false() returns false. xf:false(34) generates a compile-time error because the function does not accept any parameters.	XQuery Specification Compliance: Conforms to the current specification.
xf:not	Data Types: Input data type: xs:boolean? Returned data type: xs:boolean? Description: Returns true if the value of the source value is false and false if the value of the source value is true. Examples: xf:not(xf:false()) returns the boolean value true. xf:not(xf:true()) returns the boolean value false. xf:not(32) generates a compile-time error because the input value is not boolean. xf:not(()) returns the boolean value true.	XQuery Specification Compliance: Liquid Data accepts an optional boolean value instead of a sequence as input. Liquid Data returns a true value if the input is an empty list. Liquid Data returns an optional boolean value instead of one boolean value.
xf:true	Data Types: Input data type: No input data required. Returned data type: xs:boolean Description: Returns the boolean value true. Examples: xf:true() returns true. xf:true("34") generates a compile-time error because the function does not accept any parameters.	XQuery Specification Compliance: Conforms to the current specification.

Function Name

Data Type, Description, and Examples

Notes and XQuery Compliance

xf:false

Data Types:

Input data type: No input data required.

Returned data type: xs:boolean

Description:

Returns the boolean value false.

Examples:

xf:false() returns false.

xf:false(34) generates a compile-time error because the function does not accept any parameters.

XQuery Specification Compliance:

Conforms to the current specification.

xf:not

Data Types:

Input data type: xs:boolean?

Returned data type: xs:boolean?

Description:

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

Examples:

xf:not(xf:false()) returns the boolean value true.

xf:not(xf:true()) returns the boolean value false.

xf:not(32) generates a compile-time error because the input value is not boolean.

xf:not(()) returns the boolean value true.

XQuery Specification Compliance:

Liquid Data accepts an optional boolean value instead of a sequence as input.

Liquid Data returns a true value if the input is an empty list.

Liquid Data returns an optional boolean value instead of one boolean value.

xf:true

Data Types:

Input data type: No input data required.

Returned data type: xs:boolean

Description:

Returns the boolean value true.

Examples:

xf:true() returns true.

xf:true("34") generates a compile-time error because the function does not accept any parameters.

XQuery Specification Compliance:

Conforms to the current specification.

Table A-5 Accessor Functions

Function Name	Data Type, Description, and Examples	Notes and XQuery Specification Compliance
xf:boolean-from-string	Data Types: Input data type: xs:string? Returned data type: xs:boolean? Description: Returns a boolean value of true or false from the string source value. Examples: xf:boolean-from-string("true") returns the boolean value true. xf:boolean-from-string("FaLSe") returns the boolean value false. xf:boolean-from-string("43") generates a runtime error because the input value cannot be parsed into a boolean value. xf:boolean-from-string(43) generates a compile-time error because the input value is not a string.	Notes: If the input parameter is empty, the function returns an empty list. Otherwise, Liquid Data generates an error. XQuery Specification Compliance: Conforms to the current specification; however, Liquid Data does not accept the values "1" and "0" to represent true and false, as described in the W3C XML Schema document.
xf:byte	Data Types: Input data type: xsext:anyValue? Returned data type: xs:byte? Description: Constructs a byte integer value from the string source value. Examples: xf:byte('127') returns the byte value one hundred twenty seven. xf:byte(38) returns the byte value 38. xf:byte("-4") returns the byte value -4. xf:byte(128) returns the byte value -128 because the number wraps. xf:byte(-129) returns the byte value 127 because the number wraps. xf:byte(xf:true()) returns the byte value 1. xf:byte(xf:false()) returns the byte value 0. xf:byte("true") generates a runtime error because the string literal cannot be converted to a byte value. xf:byte('128') returns an error because one hundred twenty eight is invalid for a byte integer expression.	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: Liquid Data does not support not-a-number (NaN) or -0. Liquid Data attempts to support any input value and convert it at run time.
xf:decimal	Data Types: Input data type: xsext:anyValue? Returned data type: xs:decimal? Description: Constructs a decimal value from the source value. Examples: xf:decimal("3") returns the decimal value 3. xf:decimal(99.1) returns the decimal value 99.1 (the same value that is input to the function). xf:decimal(xf:true()) returns the decimal value 1. xf:decimal(xf:false()) returns the decimal value 0. xf:decimal("true") generates a runtime error because the string literal cannot be converted to a decimal value.	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. Liquid Data supports "e" and "E" to construct floating point integer values.
xf:double	Data Types: Input data type: xsext:anyValue? Returned data type: xs:double? Description: Constructs a double precision value from the source value. Examples: xf:double("3") returns the double precision floating point value 3.0. xf:double(5.1) returns the double precision floating point value 5.1. xf:double(xf:true()) returns the double precision floating point value 1.0. xf:double(xf:false()) returns the double precision floating point value 0.0. xf:double("true") generates a runtime error because the string literal cannot be converted to a double precision floating point value. xf:double("12345678901234567890") evaluates to the double precision floating point value 1.2345678901234567E19.	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.
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: xf:float(1) returns the floating-point value 1.0. xf:float("1") returns the floating-point value 1.0. xf:float(xf:true()) returns the floating point value 1.0. xf:float(xf:false()) returns the floating-point value 0.0. xf:float("true") generates a runtime error because the string literal cannot be converted to a floating-point value. xf:float("12345678901234567890") returns the floating-point value 1.2345679E19.	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.
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: xf:int(4056) returns the int value 4056. xf:int("-35") returns the int value -35. xf:int(xf:true()) returns the int value 1. xf:int(xf:false()) returns the int value 0. xf:int("true") generates a runtime error because the string literal cannot be converted to an int value.	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: Liquid Data does not support not-a-number (NaN) or -0. Liquid Data attempts to support any input value, instead of just string literals, and convert it at run time.
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: xf:integer(4056) returns the int value 4056. xf:integer("-35") returns the int value -35. xf:integer(xf:true()) returns the int value 1. xf:integer(xf:false()) returns the int value 0. xf:integer("true") generates a runtime error because the string literal cannot be converted to an int value.	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: 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.
xf:long	Data Types: Input data type: xsext:anyValue? Returned data type: xs:long? 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: xf:long(1) returns the long integer value 1. xf:long("-91") returns the long integer value -91. xf:long(xf:true()) returns the long integer value 1. xf:long(xf:false()) returns the long integer value 0. xf:long("true") generates a runtime error because the string literal cannot be converted to a long integer value.	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: Liquid Data does not support not-a-number (NaN) or -0. Liquid Data attempts to support any input value, instead of just string literals, and convert it at run time.
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: xf:short(1) returns the short integer value 1. xf:short("-91") returns the short integer value -91. xf:short(xf:true()) returns the short integer value 1. xf:short(xf:false()) returns the short integer value 0. xf:short("true") generates an error because the string literal cannot be converted to a short integer value.	Notes: An error occurs if the source value is greater than 32,767 or less than -32,768. XQuery Specification Compliance: Liquid Data does not support not-a-number (NaN) or -0. Liquid Data attempts to support any input value, instead of just string literals, and convert it at run time.
xf:string	Data Types: Input data type: xs:anyType Returned data type: xs:string? 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: xf:string(1) returns the string value "1." xf:string("-91") returns the string value "-91." xf:string(xf:true()) returns the string value "true." xf:string(xf:false()) returns the string value "false." xf:string("abc", "def") generates a compile-time error because the function does not accept two parameters. xf:string(("abc", "def")) generates a compile-time error because the function does not accept a sequence as parameter. xf:string(<a/>) returns an empty string value "". xf:string(<a>abc</a>) returns the string value "abc."	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: Liquid Data treats xf:string as both a constructor and an accessor. Liquid Data supports only the string format that requires one node of any type as the input. Liquid Data accepts xsext:anyType input instead of a list of items. Liquid Data returns an optional string. Liquid Data does not recognize entities.

Function Name

Data Type, Description, and Examples

Notes and XQuery Specification Compliance

xf:boolean-from-string

Data Types:

Input data type: xs:string?

Returned data type: xs:boolean?

Description:

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

Examples:

xf:boolean-from-string("true") returns the boolean value true.

xf:boolean-from-string("FaLSe") returns the boolean value false.

xf:boolean-from-string("43") generates a runtime error because the input value cannot be parsed into a boolean value.

xf:boolean-from-string(43) generates a compile-time error because the input value is not a string.

Notes:

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

XQuery Specification Compliance:

Conforms to the current specification; however, Liquid Data does not accept the values "1" and "0" to represent true and false, as described in the W3C XML Schema document.

xf:byte

Data Types:

Input data type: xsext:anyValue?

Returned data type: xs:byte?

Description:

Constructs a byte integer value from the string source value.

Examples:

xf:byte('127') returns the byte value one hundred twenty seven.

xf:byte(38) returns the byte value 38.

xf:byte("-4") returns the byte value -4.

xf:byte(128) returns the byte value -128 because the number wraps.

xf:byte(-129) returns the byte value 127 because the number wraps.

xf:byte(xf:true()) returns the byte value 1.

xf:byte(xf:false()) returns the byte value 0.

xf:byte("true") generates a runtime error because the string literal cannot be converted to a byte value.

xf:byte('128') returns an error because one hundred twenty eight is invalid for a byte integer expression.

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:

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

Liquid Data attempts to support any input value and convert it at run time.

xf:decimal

Data Types:

Input data type: xsext:anyValue?

Returned data type: xs:decimal?

Description:

Constructs a decimal value from the source value.

Examples:

xf:decimal("3") returns the decimal value 3.

xf:decimal(99.1) returns the decimal value 99.1 (the same value that is input to the function).

xf:decimal(xf:true()) returns the decimal value 1.

xf:decimal(xf:false()) returns the decimal value 0.

xf:decimal("true") generates a runtime error because the string literal cannot be converted to a decimal value.

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.

Liquid Data supports "e" and "E" to construct floating point integer values.

xf:double

Data Types:

Input data type: xsext:anyValue?

Returned data type: xs:double?

Description:

Constructs a double precision value from the source value.

Examples:

xf:double("3") returns the double precision floating point value 3.0.

xf:double(5.1) returns the double precision floating point value 5.1.

xf:double(xf:true()) returns the double precision floating point value 1.0.

xf:double(xf:false()) returns the double precision floating point value 0.0.

xf:double("true") generates a runtime error because the string literal cannot be converted to a double precision floating point value.

xf:double("12345678901234567890") evaluates to the double precision floating point value 1.2345678901234567E19.

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.

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:

xf:float(1) returns the floating-point value 1.0.

xf:float("1") returns the floating-point value 1.0.

xf:float(xf:true()) returns the floating point value 1.0.

xf:float(xf:false()) returns the floating-point value 0.0.

xf:float("true") generates a runtime error because the string literal cannot be converted to a floating-point value.

xf:float("12345678901234567890") returns the floating-point value 1.2345679E19.

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.

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:

xf:int(4056) returns the int value 4056.

xf:int("-35") returns the int value -35.

xf:int(xf:true()) returns the int value 1.

xf:int(xf:false()) returns the int value 0.

xf:int("true") generates a runtime error because the string literal cannot be converted to an int value.

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:

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

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

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:

xf:integer(4056) returns the int value 4056.

xf:integer("-35") returns the int value -35.

xf:integer(xf:true()) returns the int value 1.

xf:integer(xf:false()) returns the int value 0.

xf:integer("true") generates a runtime error because the string literal cannot be converted to an int value.

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:

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.

xf:long

Data Types:

Input data type: xsext:anyValue?

Returned data type: xs:long?

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:

xf:long(1) returns the long integer value 1.

xf:long("-91") returns the long integer value -91.

xf:long(xf:true()) returns the long integer value 1.

xf:long(xf:false()) returns the long integer value 0.

xf:long("true") generates a runtime error because the string literal cannot be converted to a long integer value.

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:

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

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

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:

xf:short(1) returns the short integer value 1.

xf:short("-91") returns the short integer value -91.

xf:short(xf:true()) returns the short integer value 1.

xf:short(xf:false()) returns the short integer value 0.

xf:short("true") generates an error because the string literal cannot be converted to a short integer value.

Notes:

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

XQuery Specification Compliance:

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

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

xf:string

Data Types:

Input data type: xs:anyType

Returned data type: xs:string?

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:

xf:string(1) returns the string value "1."

xf:string("-91") returns the string value "-91."

xf:string(xf:true()) returns the string value "true."

xf:string(xf:false()) returns the string value "false."

xf:string("abc", "def") generates a compile-time error because the function does not accept two parameters.

xf:string(("abc", "def")) generates a compile-time error because the function does not accept a sequence as parameter.

xf:string(<a/>) returns an empty string value "".

xf:string(<a>abc</a>) returns the string value "abc."

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:

Liquid Data treats xf:string as both a constructor and an accessor.

Liquid Data supports only the string format that requires one node of any type as the input.

Liquid Data accepts xsext:anyType input instead of a list of items.

Liquid Data returns an optional string.

Liquid Data does not recognize entities.

Table 7-1 Date and Time Patterns

This Symbol	Represents This Data	Produces This Result
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

Table A-6 Node Functions

Function Name	Data Type, Description, and Examples	Notes and XQuery Specification Compliance
xf:local-name	Data Types: Input data type: xsext:node Returned data type: xs:string? Description: Returns a string value that corresponds to the local name of the specified node. Examples: xf:local-name(<db:homes/>) returns the string value "homes." xf:local-name(73) generates a compile-time error because the parameter is a number and not a node.	XQuery Specification Compliance: Liquid Data does not support the format that accepts no input parameters. Liquid Data supports an optional string as the returned value instead of a required string.

Function Name

Data Type, Description, and Examples

Notes and XQuery Specification Compliance

xf:local-name

Data Types:

Input data type: xsext:node

Returned data type: xs:string?

Description:

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

Examples:

xf:local-name(<db:homes/>) returns the string value "homes."

xf:local-name(73) generates a compile-time error because the parameter is a number and not a node.

XQuery Specification Compliance:

Liquid Data does not support the format that accepts no input parameters.

Liquid Data supports an optional string as the returned value instead of a required string.

Table A-7 Numeric Functions

Function Name	Data Type, Description, and Examples	Notes and XQuery Specification Compliance
xf:ceiling	Data Types: Input data type: xs:double? Returned data type: xs:integer? Description: Returns the smallest (closest to negative infinity) integer that is not smaller than the source value. Examples: xf:ceiling(38.3) returns the integer value 39. xf:ceiling(38) returns the integer value 38. xf:ceiling(-3.3) returns the integer value -3. xf:ceiling("38.3") generates a compile-time error because the parameter is a string and not a numeric value.	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: Input data type: xs:double? Returned data type: xs:integer? Description: Returns the largest (closest to positive infinity) integer that is not greater than the source value. Examples: xf:floor(38.3) returns the integer value 38. xf:floor(38) returns the integer value 38. xf:floor(-3.3) returns the integer value -4. xf:floor("38.3") generates a compile-time error because the parameter is a string and not a numeric value.	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: Input data type: xs:double? Returned data type: xs:integer? Description: Returns the integer that is closest to the source value. Examples: xf:round(3) returns the integer value 3. xf:round(3.3) returns the integer value 3. xf:round(3.5) returns the integer value 4. xf:round(3.7) returns the integer value 4. xf:round(-3.3) returns the integer value -3. xf:round(-3.5) returns the integer value -3. xf:round(-3.7) returns the integer value -4. xf:round(-0) returns the integer value 0. xf:round("3.3") generates an error because the parameter is a string and not a numeric value.	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.

Function Name

Data Type, Description, and Examples

Notes and XQuery Specification Compliance

xf:ceiling

Data Types:

Input data type: xs:double?

Returned data type: xs:integer?

Description:

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

Examples:

xf:ceiling(38.3) returns the integer value 39.

xf:ceiling(38) returns the integer value 38.

xf:ceiling(-3.3) returns the integer value -3.

xf:ceiling("38.3") generates a compile-time error because the parameter is a string and not a numeric value.

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:

Input data type: xs:double?

Returned data type: xs:integer?

Description:

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

Examples:

xf:floor(38.3) returns the integer value 38.

xf:floor(38) returns the integer value 38.

xf:floor(-3.3) returns the integer value -4.

xf:floor("38.3") generates a compile-time error because the parameter is a string and not a numeric value.

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:

Input data type: xs:double?

Returned data type: xs:integer?

Description:

Returns the integer that is closest to the source value.

Examples:

xf:round(3) returns the integer value 3.

xf:round(3.3) returns the integer value 3.

xf:round(3.5) returns the integer value 4.

xf:round(3.7) returns the integer value 4.

xf:round(-3.3) returns the integer value -3.

xf:round(-3.5) returns the integer value -3.

xf:round(-3.7) returns the integer value -4.

xf:round(-0) returns the integer value 0.

xf:round("3.3") generates an error because the parameter is a string and not a numeric value.

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.

Table A-8 Comparison and Numeric Operators

Name	Data Type, Description, and Examples	Notes and XQuery Specification Compliance
* (Multiply)	Data Types: Parameter1 data type: xs:anyValue? Parameter2 data type: xs:anyValue? Returned data type: xs:anyValue? Description: Returns the arithmetic product of the operands: ($operand1$operand2). Examples:* 12 * 3 returns the decimal value 36. xf:integer("1") * 3.1 returns the decimal value 3.1. "abc" * "cde" generates a compile-time error because the operator can be used only with numbers.	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: If both parameters are promotable to xs:decimal, the operator returns their product as a decimal value. If both parameters are promotable to xs:float, the operator returns their product as a floating point value. If both parameters are promotable to xs:double, the operator returns their product as a double precision value. Otherwise, an error occurs because one of the parameters is not a number. XQuery Specification Compliance: Liquid Data supports only numeric multiplication (op:numeric-multiply) and no other backup functions. It does not support values, such as xs:yearMonthDuration and xs:dayTimeDuration. Liquid Data does not support not-a-number (NaN), -0, or the negative and positive infinity values -INF and INF.
+ (Add)	Data Types: Parameter1 data type: xs:anyValue? Parameter2 data type: xs:anyValue? Returned data type: xs:anyValue? Description: Returns the arithmetic sum of the operands: ($operand1+$operand2). Examples: 20 + 1 returns the decimal value 21. xf:integer("1") + 3.1 returns the decimal value 4.1. "abc" + "cde" generates a compile-time error because the operator can only be used with numbers.	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: If both parameters are promotable to xs:decimal, the operator returns their sum as a decimal value. If both parameters are promotable to xs:float, the operator returns their sum as a floating point value. If both parameters are promotable to xs:double, the operator returns their sum as a double precision value. Otherwise, an error occurs because one of the parameters is not a number. XQuery Specification Compliance: Liquid Data supports only numeric multiplication (op:numeric-add) and no other backup functions. It does not support values, such as xs:yearMonthDuration and xs:dayTimeDuration. Liquid Data does not support not-a-number (NaN), -0, or the negative and positive infinity values -INF and INF. <

Name

Data Type, Description, and Examples

Notes and XQuery Specification Compliance

* (Multiply)

Data Types:

Parameter1 data type: xs:anyValue?

Parameter2 data type: xs:anyValue?

Returned data type: xs:anyValue?

Description:

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

Examples:

12 * 3 returns the decimal value 36.

xf:integer("1") * 3.1 returns the decimal value 3.1.

"abc" * "cde" generates a compile-time error because the operator can be used only with numbers.

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:

If both parameters are promotable to xs:decimal, the operator returns their product as a decimal value.

If both parameters are promotable to xs:float, the operator returns their product as a floating point value.

If both parameters are promotable to xs:double, the operator returns their product as a double precision value.

Otherwise, an error occurs because one of the parameters is not a number.

XQuery Specification Compliance:

Liquid Data supports only numeric multiplication (op:numeric-multiply) and no other backup functions. It does not support values, such as xs:yearMonthDuration and xs:dayTimeDuration.

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

+ (Add)

Data Types:

Parameter1 data type: xs:anyValue?

Parameter2 data type: xs:anyValue?

Returned data type: xs:anyValue?

Description:

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

Examples:

20 + 1 returns the decimal value 21.

xf:integer("1") + 3.1 returns the decimal value 4.1.

"abc" + "cde" generates a compile-time error because the operator can only be used with numbers.

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:

If both parameters are promotable to xs:decimal, the operator returns their sum as a decimal value.

If both parameters are promotable to xs:float, the operator returns their sum as a floating point value.

If both parameters are promotable to xs:double, the operator returns their sum as a double precision value.

Otherwise, an error occurs because one of the parameters is not a number.

XQuery Specification Compliance:

Liquid Data supports only numeric multiplication (op:numeric-add) and no other backup functions. It does not support values, such as xs:yearMonthDuration and xs:dayTimeDuration.

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