Compare |
|
 |
Description
|
Performs a case-sensitive comparison of two strings.
|
|
Returns
- -1, if string1 is less than string2
- 0, if string1 is equal to string2
- 1, if string1 is greater than string2
|
|
Category
|
String functions
|
|
Function syntax |
Compare(string1, string2)
|
|
See also
|
CompareNoCase, Find
|
|
Parameters
|
|
Parameter |
Description |
string1 |
A string or a variable that contains one |
string2 |
A string or a variable that contains one |
|
|
Usage
|
Compares the values of corresponding characters in string1 and string2.
|
|
Example<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">
<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>
|