lower-case function

Syntax

source-string

The string that is to be converted to lowercase.

source-string is of type xs:string, or is the empty sequence.

locale-name

A string containing the locale to be used for the lowercase operation.

locale-name is of type xs:string, or is the empty sequence. If locale-name is not the empty sequence, the value of locale-name is not case sensitive and must be a valid locale or a string of length zero.

Returned value

If source-string is not the empty sequence, the returned value is source-string with each character converted to its lowercase correspondent. If locale-name is not specified, is the empty sequence, or is a string of length zero, then the lowercase rules as defined in the Unicode standard are used. Otherwise, the lowercase rules for the specified locale are used. Every character that does not have a lowercase correspondent is included in the returned value in its original form.

If source-string is the empty sequence, the returned value is a string of length zero.

Examples

The following function converts the string "Wireless Router TB2561" to lowercase:

fn:lower-case("Wireless Router TB2561")

The returned value is "wireless router tb2561"

The following function specifies the Turkish locale tr_TR and converts the letter "I" and the numeric character reference İ (the character reference for Latin upper case I with dot above).

fn:lower-case("Iİ", "tr_TR")

The returned value consists of two characters, the character represented by ı (Latin small letter dotless i), and the letter "i." For the Turkish locale, the letter "I" is converted to the character represented by ı (Latin small letter dotless i), and İ (Latin upper case I with dot above) is converted to "i."

The following function does not specify a locale and converts the letter "I" to lowercase using the rules defined in the Unicode standard.

fn:lower-case("I")

The returned value is the letter "i."