XPath/XQuery codepoints-to-string function

Summary

Returns an xs:string whose characters have supplied codepoints.

Signature

fn:codepoints-to-string(
$arg as xs:integer*
) as xs:string

Properties

This function is deterministic, context-independent, and focus-independent.

Rules

The function returns the string made up from the characters whose Unicode codepoints are supplied in $arg. This will be the zero-length string if $arg is the empty sequence.

Examples

The expression fn:codepoints-to-string((66, 65, 67, 72)) returns "BACH".

The expression fn:codepoints-to-string((2309, 2358, 2378, 2325)) returns "अशॊक".

The expression fn:codepoints-to-string(()) returns "".

The expression fn:codepoints-to-string(0) returns .

Error Conditions

A dynamic error is raised if any of the codepoints in $arg is not a permitted XML character.