Compare

Performs a case-sensitive comparison of two strings. Returns a negative number if string1 is less than string2; 0 if string1 is equal to string2; or a positive number if string1 is greater than string2.

See also CompareNoCase and Find.

Syntax

Compare(string1, string2)
string1, string2

Strings to be compared.

Usage

The comparison is performed on the ASCII values (character codes) of corresponding characters in string1 and string2.

If many strings are sorted in increasing order based on the Compare function, they appear listed in dictionary order.

Examples

<!--- This example shows the use of Compare --->
<HTML>
<HEAD>
<TITLE>
Compare Example
</TITLE>
</HEAD>

<BODY bgcolor=silver>
<H3>Compare Example</H3>
<P>The compare function  performs a <I>case-sensitive</I>
comparison of two strings.

<CFIF IsDefined("FORM.string1")>
  <CFSET comparison=Compare(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="compare.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>

</BODY>
</HTML>