Design

Back Next

codepoints-to-string

The codepoints-to-string function in XQuery is used to construct a string from a sequence of Unicode code points. This function takes numeric representations of characters and converts them into a string.

Syntax

fn:codepoints-to-string(arg)

The following table describes the argument for this command:

Argument	Required/Optional	Description
arg	Required	A sequence of integers representing Unicode code points. Each integer corresponds to a Unicode code point that is converted into the respective character in the resulting string.

Return Value

Returns a string formed by converting each code point in the input sequence to its corresponding character. If

empty-sequence()

is provided, it returns an empty string.

If any of the code points in

$arg

is not a legal XML character, an error occurs.

Examples

The following table lists some sample values and return values:

SAMPLE FUNCTION	OUTPUT
fn:codepoints-to-string((97, 32, 98, 32, 99))	a b c
fn:codepoints-to-string(97)	a
fn:codepoints-to-string(())	zero-length string
fn:codepoints-to-string((72, 101, 108, 108, 111))	"Hello"
fn:codepoints-to-string((87, 111, 114, 108, 100, 32, 88, 81, 117, 101, 114, 121))	"World XQuery"