Comparer Class
Compares two objects for equivalence, where string comparisons are case-sensitive.
Assembly: mscorlib (in mscorlib.dll)
The Comparer type exposes the following members.
| Name | Description | |
|---|---|---|
![]() ![]() | Comparer | Initializes a new instance of the Comparer class using the specified System.Globalization::CultureInfo. |
| Name | Description | |
|---|---|---|
![]() ![]() | Compare | Performs a case-sensitive comparison of two objects of the same type and returns a value indicating whether one is less than, equal to, or greater than the other. |
![]() ![]() | Equals(Object) | Determines whether the specified Object is equal to the current Object. (Inherited from Object.) |
![]() ![]() | Finalize | Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.) |
![]() ![]() | GetHashCode | Serves as a hash function for a particular type. (Inherited from Object.) |
![]() | GetObjectData | Populates a SerializationInfo object with the data required for serialization. |
![]() ![]() | GetType | Gets the Type of the current instance. (Inherited from Object.) |
![]() ![]() | MemberwiseClone | Creates a shallow copy of the current Object. (Inherited from Object.) |
![]() ![]() | ToString | Returns a string that represents the current object. (Inherited from Object.) |
| Name | Description | |
|---|---|---|
![]() ![]() ![]() | Default | Represents an instance of Comparer that is associated with the Thread::CurrentCulture of the current thread. This field is read-only. |
![]() ![]() ![]() | DefaultInvariant | Represents an instance of Comparer that is associated with CultureInfo::InvariantCulture. This field is read-only. |
This class is the default implementation of the IComparer interface. The CaseInsensitiveComparer class is the implementation of the IComparer interface that performs case-insensitive string comparisons.
Comparison procedures use the Thread::CurrentCulture of the current thread unless otherwise specified. String comparisons might have different results depending on the culture. For more information on culture-specific comparisons, see the System.Globalization namespace and Encoding and Localization.
The following code example shows how Compare returns different values depending on the culture associated with the Comparer.
using namespace System; using namespace System::Collections; using namespace System::Globalization; int main() { // Creates the strings to compare. String^ str1 = "llegar"; String^ str2 = "lugar"; Console::WriteLine( "Comparing \"{0}\" and \"{1}\" ...", str1, str2 ); // Uses the DefaultInvariant Comparer. Console::WriteLine( " Invariant Comparer: {0}", Comparer::DefaultInvariant->Compare( str1, str2 ) ); // Uses the Comparer based on the culture "es-ES" (Spanish - Spain, international sort). Comparer^ myCompIntl = gcnew Comparer( gcnew CultureInfo( "es-ES",false ) ); Console::WriteLine( " International Sort: {0}", myCompIntl->Compare( str1, str2 ) ); // Uses the Comparer based on the culture identifier 0x040A (Spanish - Spain, traditional sort). Comparer^ myCompTrad = gcnew Comparer( gcnew CultureInfo( 0x040A,false ) ); Console::WriteLine( " Traditional Sort : {0}", myCompTrad->Compare( str1, str2 ) ); } /* This code produces the following output. Comparing "llegar" and "lugar" ... Invariant Comparer: -1 International Sort: -1 Traditional Sort : 1 */
Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
