Int32.CompareTo Metode

Definisi

Ruang nama:

System

Rakitan:

netstandard.dll, System.Runtime.dll

Membandingkan instans ini dengan bilangan bulat bertanda tangan 32-bit tertentu dan mengembalikan indikasi nilai relatifnya.

Overload

Nama	Deskripsi
CompareTo(Int32)	Membandingkan instans ini dengan bilangan bulat bertanda tangan 32-bit tertentu dan mengembalikan indikasi nilai relatifnya.
CompareTo(Object)	Membandingkan instans ini dengan objek tertentu dan mengembalikan indikasi nilai relatifnya.

CompareTo(Int32)

Sumber:

Int32.cs

Membandingkan instans ini dengan bilangan bulat bertanda tangan 32-bit tertentu dan mengembalikan indikasi nilai relatifnya.

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

Parameter

value

Int32

Bilangan bulat untuk dibandingkan.

Mengembalikan

Int32

Nomor yang ditandatangani menunjukkan nilai relatif instans ini dan value.

Mengembalikan Nilai	Deskripsi
Kurang dari nol	Instans ini kurang dari value.
Nol	Instans ini sama dengan value.
Lebih besar dari nol	Instans ini lebih besar dari value.

Penerapan

CompareTo(T)

Contoh

Contoh berikut menunjukkan Int32.CompareTo(Int32) metode . Selain menampilkan nilai yang dikembalikan oleh metode untuk empat perbandingan yang berbeda, ia mengonversi nilai pengembalian menjadi anggota enumerasi kustom Comparison , yang nilainya juga ditampilkan.

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).

Keterangan

Metode ini mengimplementasikan antarmuka System.IComparable<T> dan berkinerja sedikit lebih baik daripada metode Int32.CompareTo karena tidak harus mengonversi parameter value menjadi objek.

Bergantung pada bahasa pemrograman Anda, mungkin untuk mengimplementasikan metode CompareTo di mana tipe parameter memiliki bit lebih sedikit (lebih sempit) daripada tipe instance. Hal ini dimungkinkan karena beberapa bahasa pemrograman melakukan konversi pelebaran implisit yang mewakili parameter sebagai tipe dengan jumlah bit yang sama banyaknya dengan instans.

Misalnya, misalkan jenis instans adalah Int32 dan jenis parameternya adalah Byte. Pengkompilasi C# Microsoft menghasilkan instruksi untuk mewakili nilai parameter sebagai Int32, lalu menghasilkan metode Int32.CompareTo yang membandingkan nilai instans Int32 dan representasi parameter Int32.

Lihat dokumentasi bahasa pemrograman Anda untuk menentukan apakah pengkompilasinya melakukan konversi pelesiran implisit pada jenis numerik.

Lihat juga

• UInt32
• Equals(Object)

CompareTo(Object)

Sumber:

Int32.cs

Membandingkan instans ini dengan objek tertentu dan mengembalikan indikasi nilai relatifnya.

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

Parameter

value

Object

Objek untuk dibandingkan, atau null.

Mengembalikan

Int32

Nomor yang ditandatangani menunjukkan nilai relatif instans ini dan value.

Mengembalikan Nilai	Deskripsi
Kurang dari nol	Instans ini kurang dari value.
Nol	Instans ini sama dengan value.
Lebih besar dari nol	Instans ini lebih besar dari value, atau value .null

Penerapan

CompareTo(Object)

Pengecualian

ArgumentException

valuebukan .Int32

Keterangan

Setiap contoh Int32, terlepas dari nilainya, dianggap lebih besar dari null.

value harus atau null instans Int32; jika tidak, pengecualian dilemparkan.

Lihat juga

• UInt32
• Equals(Object)