UcFirst()

edit

Capitalizes the first character of the given string.


	UcFirst( string=string, doAll=boolean, doLowerIfAllUppercase=boolean );

Returns: String

Argument	Description
string _{string, required}	edit the input string
doAll _{boolean, optional}	edit If true, then every word is capitalized, where a new word is defined as alpha characters that come after whitespace, a dot [.], a dash [-], or (parenthesis). This is especially useful to clean up user input of names, e.g. converting a string like "susi q. sorgolis" to "Susi Q. Sorgolis"
doLowerIfAllUppercase _{boolean, optional}	edit If true, then if the input string contains letters and they are all UPPERCASE, then the input string is first lowercased. When combined with the doAll argument, this is especially useful to clean user input of names when they are all UPPERCASE, e.g. converting "SUSI Q. SORGOLIS" to "Susi Q. Sorgolis" while preserving the CaSe if the input is e.g. "Ronald McDonald"

Argument

Description

string

_{string,

required}

edit

the input string

doAll

_{boolean,

optional}

edit

If true, then every word is capitalized, where a new word is defined as alpha characters that come after whitespace, a dot [.], a dash [-], or (parenthesis).

This is especially useful to clean up user input of names, e.g. converting a string like "susi q. sorgolis" to "Susi Q. Sorgolis"

doLowerIfAllUppercase

_{boolean,

optional}

edit

If true, then if the input string contains letters and they are all UPPERCASE, then the input string is first lowercased.

When combined with the doAll argument, this is especially useful to clean user input of names when they are all UPPERCASE, e.g. converting "SUSI Q. SORGOLIS" to "Susi Q. Sorgolis" while preserving the CaSe if the input is e.g. "Ronald McDonald"

Examples

edit

string = "submitting bugs and feature requests via our online system";

dump(UcFirst(string, false, false));
dump(UcFirst(string, true, false));

UcFirst()

Examples

See also