User Guide
Chapter 2: ColdFusion Functions 293
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>