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; "Ambiguous type expressions and strings" in Chapter 3, "Using ColdFusion Variables," in ColdFusion MX Developer's Guide

 
Parameters

 
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>

A string or a variable that contains one

STRING1  

A string or a variable that contains one

STRING2