(Engine-Level Function)
| Description: | Case Insensitive Text Comparison |
| Returns: | Numeric |
Usage:  |
Script or steady state. |
| Function Groups: | String and Buffer |
| Purpose: | This function performs a case insensitive comparison of two text expressions and returns an indication of whether the first string is greater than, less than or equal to the second. |
| Related to: | StrCmp | StrLen |
| Format: |
StrICmp(String1, String2) |
| Parameters: |
| String1 |
| Required. Any text expression giving the first string to be used for the comparison. |
| String2 |
| Required. Any text expression giving the second string to be used for the comparison. |
| Comments: | When one string is referred to as greater than or less than another, it means each character has been converted to its ASCII value and the two strings have been compared character value by character value. In ASCII, the alphabet is numbered in ascending order, and uppercase letters are listed first, so their values are less than lower case letters. This function returns the following values:
Lower case letters are considered to be the same as the corresponding upper case letters. For example, "VTS" and "vts" are considered to be identical. |
Examples:
p = StrICmp("ABC", "AbC");
q = StrICmp("ABC", "ABCD");
r = StrICmp("ABCE", "abcde");
The values of p, q and r are 0, -1 and 1 respectively.
