CompareNoCase |
Description
Performs a case-insensitive comparison of two strings.
Returns
An indicator of the difference: A negative number, if string1 is less than string2 0, if string1 is equal to string2 A positive number, if string1 is greater than string2
Category
String functions
Function syntax
    CompareNoCase(string1, string2)
See also
Compare, FindNoCase
Parameters
Parameter | Description
string1 | A string or a variable that contains one
string2 | A string or a variable that contains one
Example
    <H3>CompareNoCase Example</H3>
    <P>This function performs a <I>case-insensitive</I> comparison of two strings.
    <CFIF IsDefined("form.string1")>
    <CFSET comparison = Comparenocase(form.string1, form.string2)>
    <!--- switch on the variable to give various responses --->
    <CFSWITCH EXPRESSION=#comparison#>
       <CFCASE value="-1">
          <H3>String 1 is less than String 2</H3>
          <I>The strings are not equal</I>
       </CFCASE>
       <CFCASE value="0">
          <H3>String 1 is equal to String 2</H3>
          <I>The strings are equal!</I>
       </CFCASE>
       <CFCASE value="1">
          <H3>String 1 is greater than String 2</H3>
          <I>The strings are not equal</I>
       </CFCASE>
       <CFDEFAULTCASE>
          <H3>This is the default case</H3>
       </CFDEFAULTCASE>
    </CFSWITCH>
    </CFIF>
    <FORM ACTION="comparenocase.cfm" METHOD="POST">
    <P>String 1
    <BR><INPUT TYPE="Text" NAME="string1">
    <P>String 2
    <BR><INPUT TYPE="Text" NAME="string2">
    <P><INPUT TYPE="Submit" VALUE="Compare these Strings" NAME="">
    <INPUT TYPE="RESET">
    </FORM>

string1 |
A string or a variable that contains one

string2 |
A string or a variable that contains one