Design

Back Next

string-to-codepoints

The string-to-codepoints function in XQuery is used to convert a string into a sequence of Unicode codepoints. This function provides a way to analyze and manipulate the individual characters embedded within a string at their fundamental encoding level.

Syntax

fn:string-to-codepoints(arg)

The following table describes the argument for this command:

Argument	Required/Optional	Description
arg	Required	The input string to be converted into Unicode codepoints. If the argument is an empty sequence ( () ), it is treated as an empty string.

Return Value

Returns a sequence of integers representing the Unicode codepoints of each character in the input string.

If the input string is empty or an empty sequence, the function returns an empty sequence.

Examples

The following table lists some sample values and return values:

SAMPLE FUNCTION	OUTPUT
fn:string-to-codepoints('abc')	(97, 98, 99)
fn:string-to-codepoints('a')	97
fn:string-to-codepoints('')	()
fn:string-to-codepoints("Hello World")	(72, 101, 108, 108, 111, 32, 87, 111, 114, 108, 100)