String::CompareOrdinal Method (String^, String^)
Compares two specified String objects by evaluating the numeric values of the corresponding Char objects in each string.
Assembly: mscorlib (in mscorlib.dll)
Parameters
- strA
-
Type:
System::String^
The first string to compare.
- strB
-
Type:
System::String^
The second string to compare.
Return Value
Type: System::Int32An integer that indicates the lexical relationship between the two comparands.
Value | Condition |
|---|---|
Less than zero | strA is less than strB. |
Zero | strA and strB are equal. |
Greater than zero | strA is greater than strB. |
This method performs a case-sensitive comparison using ordinal sort rules. For more information about word, string, and ordinal sorts, see System.Globalization::CompareOptions. To perform a case-insensitive comparison using ordinal sort rules, call the Compare(String^, String^, StringComparison) method with the comparisonType argument set to StringComparison::OrdinalIgnoreCase.
Because CompareOrdinal(String^, String^)is a static method, strA and strB can be null. If both values are null, the method returns 0 (zero), which indicates that strA and strB are equal. If only one of the values is null, the method considers the non-null value to be greater.
The following example performs and ordinal comparison of two strings that only differ in case.
// Sample for String::CompareOrdinal(String, String) using namespace System; int main() { String^ str1 = "ABCD"; String^ str2 = "abcd"; String^ str; int result; Console::WriteLine(); Console::WriteLine( "Compare the numeric values of the corresponding Char objects in each string." ); Console::WriteLine( "str1 = '{0}', str2 = '{1}'", str1, str2 ); result = String::CompareOrdinal( str1, str2 ); str = ((result < 0) ? "less than" : ((result > 0) ? (String^)"greater than" : "equal to")); Console::Write( "String '{0}' is ", str1 ); Console::Write( "{0} ", str ); Console::WriteLine( "String '{0}'.", str2 ); } /* This example produces the following results: Compare the numeric values of the corresponding Char objects in each string. str1 = 'ABCD', str2 = 'abcd' String 'ABCD' is less than String 'abcd'. */
Available since 8
.NET Framework
Available since 1.1
Portable Class Library
Supported in: portable .NET platforms
Silverlight
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Windows Phone
Available since 8.1