Design

Back Next

lower-case

The lower-case function in XQuery is used to convert all the characters in a string to lowercase. This function is useful for tasks where case-insensitivity is required, such as searching, sorting, or normalizing textual data.

Syntax

fn:lower-case(arg)

The following table describes the argument for this command:

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

Return Value

Returns a string where all the alphabetic characters in the input string have been converted to lowercase. Characters that are not alphabetic, such as numbers and punctuation remain unchanged.

Examples

The following table lists some sample values and return values:

SAMPLE FUNCTION	OUTPUT
fn:lower-case('QUERY')	query
fn:lower-case('Query')	query
fn:lower-case('query')	query
fn:lower-case('QUERY123')	query123
fn:lower-case("Hello World!")	"hello world!"
fn:lower-case("")	""
fn:lower-case("1234!@#$")	"1234!@#$"