StringLower / StringUpper

Converts a string to lowercase, uppercase or title case.

StringLower, OutputVar, InputVar , T
StringUpper, OutputVar, InputVar , T

Parameters

OutputVar

The name of the output variable in which to store newly converted string.

InputVar

The name of the input variable whose contents will be read from. Do not enclose the name in percent signs unless you want the contents of the variable to be used as the name.

T

If blank or omitted, the string will be converted to lowercase or uppercase only. Otherwise, specify the letter T to convert the string to title case. For example, "GONE with the WIND" would become "Gone With The Wind".

Remarks

To detect whether a character or string is entirely uppercase or lowercase, use If Var is [not] Type.

For this and all other commands, OutputVar is allowed to be the same variable as InputVar.

[v1.1.20+]: Format() can also be used for case conversions, as shown below:

MsgBox % Format("{:U}, {:L} and {:T}", "upper", "LOWER", "title")

Format(), IfInString, StringGetPos, StringMid, StringTrimLeft, StringTrimRight, StringLeft, StringRight, StringLen, StrReplace(), StringReplace

Examples

Converts the string to lowercase and stores "this is a test." in String1.

String1 := "This is a test."
StringLower, String1, String1  ; i.e. output can be the same as input.

Converts the string to uppercase and stores "THIS IS A TEST." in String2.

String2 := "This is a test."
StringUpper, String2, String2

Converts the string to title case and stores "This Is A Test." in String3. Note that the same effect would be achieved by using StringLower instead of StringUpper.

String3 := "This is a test."
StringUpper, String3, String3, T