Adobe ColdFusion 8

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 the ColdFusion Developer's Guide

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>