Class: String
Description
This method returns the lowercase version of a string. The first character can optionally be capitalized. This method replaces the $$LOWER^%ZFUNC() function.
Syntax
StringObject.lowerCase(Boolean capitalizeFirstChar)
Parameters
|
capitalizeFirstChar |
A Boolean value that indicates if the first character of the result must be capitalized. If absent, 0 will be used. |
Returns
The string in which all characters are converted to lowercase characters (if capitalizeFirstChar = 0 or absent).
The string in which the first character is converted to titlecase, and all other characters are converted to lowercase (if capitalizeFirstChar = 1).c
When Became Available
v7.0
Example
type String MIXED = "Hello World!"
type String LOWER = MIXED.lowerCase() // "hello world!"
type String TITLE = MIXED.lowerCase(1) // "Hello world!"
// The example below uses the (Dutch) Unicode characters IJ (196, 178)
// and ij (196, 179) and the well-known Frysian name IJsbrand.
// The composed characters are combinations of the traditional ASCII
// characters I and J (and i and j).
// Note the difference for capitalizeFirstChar = 1
type String NAMEUNI = "IJsBrAnD" // 7 characters
type String NAMEASC = "IJsBrAnD" // 8 characters
type String LOWERUNI = NAMEUNI.lowerCase() // "ijsbrand"
type String LOWERASC = NAMEASC.lowerCase() // "ijsbrand"
type String TITLEUNI = NAMEUNI.lowerCase(1) // "IJsbrand"
type String TITLEASC = NAMEASC.lowerCase(1) // "Ijsbrand"