Design

Back Next

upper-case

The upper-case function in XQuery converts all the characters in a given string to their uppercase equivalents according to the Unicode standard. This function is helpful for normalizing text for comparison or display purposes.

Syntax

fn:upper-case(arg)

The following table describes the argument for this command:

Argument	Required/Optional	Description
arg	Required	The input string whose characters are to be converted to uppercase. If this argument is an empty sequence ( () ), it is treated as an empty string.

Return Value

Returns a new string where all lowercase letters in the input string have been converted to uppercase.

Non-alphabetic characters and characters that do not have an uppercase equivalent remain unchanged.

If the input is an empty string, it returns an empty string.

Examples

The following table lists some sample values and return values:

SAMPLE FUNCTION	OUTPUT
fn:upper-case('query')	QUERY
fn:upper-case('QUERY')	QUERY
fn:upper-case('Query')	QUERY
fn:upper-case('query-123')	QUERY-123
fn:upper-case("123abc!@#")	"123ABC!@#"
fn:upper-case("")	""