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";