StringToLower

Converts a text string to lower case.

Syntax

StringToLower( StringValue );

Parameters

Parameter Name Type Description Optional? Default Value
StringValue String The string to convert to lower case. No n/a

Output

The original string converted into lower case.

Use Case

Consider the following pair of strings:

"JAMES TIBERIUS KIRK"

"James Tiberius Kirk"

Both of them contain the same words, but because parts of the text are in a different case, the following equality comparison will return a result of False:

"JAMES TIBERIUS KIRK" = "James Tiberius Kirk";

If you wanted to create an expression that compared these two strings to make sure that they contain the same characters in spite of their case difference, you could do this by wrapping both strings with the StringToLower function, as follows:

StringToLower("JAMES TIBERIUS KIRK") = StringToLower("James Tiberius Kirk");

The new expression will return a value of True, because it is the same as evaluating the following:

"james tiberius kirk" = "james tiberius kirk";