Table of Contents
Advertisement
Chapter 2: ColdFusion Functions
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
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
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">
</CFCASE>
<CFCASE VALUE="0">
</CFCASE>
<CFCASE VALUE="1">
</CFCASE>
<CFDEFAULTCASE>
</CFDEFAULTCASE>
CompareNoCase
and Find.
performs a <I>case-sensitive</I>
<H3>String 1 is less than String 2</H3>
<I>The strings are not equal</I>
<H3>String 1 is equal to String 2</H3>
<I>The strings are equal!</I>
<H3>String 1 is greater than String 2</H3>
<I>The strings are not equal</I>
<H3>This is the default case</H3>
293
Advertisement
Table of Contents
Need help?
Do you have a question about the COLDFUSION 4.5-CFML LANGUAGE and is the answer not in the manual?