Int32.CompareTo Yöntem

Tanım

Ad Alanı:

System

Bütünleştirilmiş Kod:

System.Runtime.dll

Bu örneği belirtilen 32 bit imzalı tamsayıyla karşılaştırır ve göreli değerlerinin bir göstergesini döndürür.

Aşırı Yüklemeler

CompareTo(Int32)	Bu örneği belirtilen 32 bit imzalı tamsayıyla karşılaştırır ve göreli değerlerinin bir göstergesini döndürür.
CompareTo(Object)	Bu örneği belirtilen nesne ile karşılaştırır ve göreli değerlerin bir göstergesini döndürür.

CompareTo(Int32)

Kaynak:

Int32.cs

Bu örneği belirtilen 32 bit imzalı tamsayıyla karşılaştırır ve göreli değerlerinin bir göstergesini döndürür.

public:
 virtual int CompareTo(int value);

public int CompareTo (int value);

abstract member CompareTo : int -> int
override this.CompareTo : int -> int

Public Function CompareTo (value As Integer) As Integer

Parametreler

value

Int32

Karşılaştıracak bir tamsayı.

Döndürülenler

Int32

Bu örneğin ve valuedeğerlerini gösteren imzalı bir sayı.

Dönüş Değeri	Açıklama
Sıfırdan küçük	Bu örnek değerinden valueküçük.
Sıfır	Bu örnek eşittir value.
Sıfırdan büyük	Bu örnek değerinden valuebüyüktür.

Uygulamalar

CompareTo(T)

Örnekler

Aşağıdaki örnekte yöntemi gösterilmektedir Int32.CompareTo(Int32) . Dört farklı karşılaştırma için yöntemi tarafından döndürülen değeri görüntülemeye ek olarak, dönüş değerini, değerini de görüntülediği özel Comparison numaralandırmanın bir üyesine dönüştürür.

using System;

enum Comparison {
   LessThan=-1, Equal=0, GreaterThan=1};

public class ValueComparison
{
   public static void Main()
   {
      int mainValue = 16325;
      int zeroValue = 0;
      int negativeValue = -1934;
      int positiveValue = 903624;
      int sameValue = 16325;

      Console.WriteLine("Comparing {0} and {1}: {2} ({3}).",
                        mainValue, zeroValue,
                        mainValue.CompareTo(zeroValue),
                        (Comparison) mainValue.CompareTo(zeroValue));

      Console.WriteLine("Comparing {0} and {1}: {2} ({3}).",
                        mainValue, sameValue,
                        mainValue.CompareTo(sameValue),
                        (Comparison) mainValue.CompareTo(sameValue));

      Console.WriteLine("Comparing {0} and {1}: {2} ({3}).",
                        mainValue, negativeValue,
                        mainValue.CompareTo(negativeValue),
                        (Comparison) mainValue.CompareTo(negativeValue));

      Console.WriteLine("Comparing {0} and {1}: {2} ({3}).",
                        mainValue, positiveValue,
                        mainValue.CompareTo(positiveValue),
                        (Comparison) mainValue.CompareTo(positiveValue));
   }
}
// The example displays the following output:
//       Comparing 16325 and 0: 1 (GreaterThan).
//       Comparing 16325 and 16325: 0 (Equal).
//       Comparing 16325 and -1934: 1 (GreaterThan).
//       Comparing 16325 and 903624: -1 (LessThan).

open System

type Comparison =
    | LessThan = -1 
    | Equal = 0
    | GreaterThan = 1

let mainValue = 16325
let zeroValue = 0
let negativeValue = -1934
let positiveValue = 903624
let sameValue = 16325

printfn $"Comparing {mainValue} and {zeroValue}: {mainValue.CompareTo zeroValue} ({enum<Comparison>(mainValue.CompareTo zeroValue)})."

printfn $"Comparing {mainValue} and {sameValue}: {mainValue.CompareTo sameValue} ({enum<Comparison>(mainValue.CompareTo sameValue)})."

printfn $"Comparing {mainValue} and {negativeValue}: {mainValue.CompareTo negativeValue} ({enum<Comparison>(mainValue.CompareTo negativeValue)})." 

printfn $"Comparing {mainValue} and {positiveValue}: {mainValue.CompareTo positiveValue} ({enum<Comparison>(mainValue.CompareTo positiveValue)})."

// The example displays the following output:
//       Comparing 16325 and 0: 1 (GreaterThan).
//       Comparing 16325 and 16325: 0 (Equal).
//       Comparing 16325 and -1934: 1 (GreaterThan).
//       Comparing 16325 and 903624: -1 (LessThan).

Public Enum Comparison As Integer
   LessThan = -1
   Equal = 0
   GreaterThan = 1
End Enum

Module ValueComparison
   Public Sub Main()
      Dim mainValue As Integer = 16325
      Dim zeroValue As Integer = 0
      Dim negativeValue As Integer = -1934
      Dim positiveValue As Integer = 903624
      Dim sameValue As Integer = 16325
      
      Console.WriteLine("Comparing {0} and {1}: {2} ({3}).", _ 
                        mainValue, zeroValue, _
                        mainValue.CompareTo(zeroValue), _
                        CType(mainValue.CompareTo(zeroValue), Comparison))
                        
      Console.WriteLine("Comparing {0} and {1}: {2} ({3}).", _ 
                        mainValue, sameValue, _
                        mainValue.CompareTo(sameValue), _
                        CType(mainValue.CompareTo(sameValue), Comparison))
                        
      Console.WriteLine("Comparing {0} and {1}: {2} ({3}).", _ 
                        mainValue, negativeValue, _
                        mainValue.CompareTo(negativeValue), _
                        CType(mainValue.CompareTo(negativeValue), Comparison))
                        
      Console.WriteLine("Comparing {0} and {1}: {2} ({3}).", _ 
                        mainValue, positiveValue, _
                        mainValue.CompareTo(positiveValue), _
                        CType(mainValue.CompareTo(positiveValue), Comparison))
   End Sub
End Module
' The example displays the following output:
'       Comparing 16325 and 0: 1 (GreaterThan).
'       Comparing 16325 and 16325: 0 (Equal).
'       Comparing 16325 and -1934: 1 (GreaterThan).
'       Comparing 16325 and 903624: -1 (LessThan).

Açıklamalar

Bu yöntem arabirimini uygular ve parametresini System.IComparable<T> bir nesneye Int32.CompareTo dönüştürmesi value gerekmediğinden yönteminden biraz daha iyi performans gösterir.

Programlama dilinize bağlı olarak, parametre türünün örnek türünden daha az bit (daha dar) olduğu bir CompareTo yöntem kodlayabilirsiniz. Bazı programlama dilleri parametreyi bitler örnek kadar çokmuş gibi bir tür olarak temsil eden dolaylı bir genişletme dönüşümü gerçekleştirdiği için bu olasıdır.

Örneğin, örnek türünün ve parametre türünün olduğunu Int32Bytevarsayalım. Microsoft C# derleyicisi, parametresinin değerini olarak Int32göstermek için yönergeler oluşturur ve ardından örneğin değerlerini Int32 ve Int32 parametre gösterimini karşılaştıran bir Int32.CompareTo yöntem oluşturur.

Derleyicinin sayısal türlerde örtülü genişleme dönüştürmeleri gerçekleştirip gerçekleştirmediğini belirlemek için programlama dilinizle ilgili belgelere bakın.

Ayrıca bkz.

• UInt32
• Equals(Object)

CompareTo(Object)

Kaynak:

Int32.cs

Bu örneği belirtilen nesne ile karşılaştırır ve göreli değerlerin bir göstergesini döndürür.

public:
 virtual int CompareTo(System::Object ^ value);

public int CompareTo (object? value);

abstract member CompareTo : obj -> int
override this.CompareTo : obj -> int

Public Function CompareTo (value As Object) As Integer

Parametreler

value

Object

Karşılaştıracak bir nesne veya null.

Döndürülenler

Int32

Bu örneğin ve valuedeğerlerini gösteren imzalı bir sayı.

Dönüş Değeri	Açıklama
Sıfırdan küçük	Bu örnek değerinden valueküçük.
Sıfır	Bu örnek eşittir value.
Sıfırdan büyük	Bu örnek veya valuenulldeğerinden valuebüyüktür.

Uygulamalar

CompareTo(Object)

Özel durumlar

ArgumentException

value bir Int32değildir.

Açıklamalar

değerinden Int32bağımsız olarak herhangi bir örneği değerinden büyük nullolarak kabul edilir.

valueveya örneği Int32olmalıdırnull; aksi takdirde bir özel durum oluşturulur.

Ayrıca bkz.

• UInt32
• Equals(Object)