IComparable.CompareTo(Object) Metode
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Membandingkan objek ini dengan objek yang ditentukan untuk urutan.
[Android.Runtime.Register("compareTo", "(Ljava/lang/Object;)I", "GetCompareTo_Ljava_lang_Object_Handler:Java.Lang.IComparableInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null")]
public int CompareTo (Java.Lang.Object o);
[<Android.Runtime.Register("compareTo", "(Ljava/lang/Object;)I", "GetCompareTo_Ljava_lang_Object_Handler:Java.Lang.IComparableInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null")>]
abstract member CompareTo : Java.Lang.Object -> int
Parameter
- o
- Object
objek yang akan dibandingkan.
Mengembalikan
bilangan bulat negatif, nol, atau bilangan bulat positif karena objek ini kurang dari, sama dengan, atau lebih besar dari objek yang ditentukan.
- Atribut
Keterangan
Membandingkan objek ini dengan objek yang ditentukan untuk urutan. Mengembalikan bilangan bulat negatif, nol, atau bilangan bulat positif karena objek ini kurang dari, sama dengan, atau lebih besar dari objek yang ditentukan.
Implementor harus memastikan sgn(x.compareTo(y)) == -sgn(y.compareTo(x))
untuk semua x
dan y
. (Ini menyiratkan bahwa x.compareTo(y)
harus melempar pengecualian iff y.compareTo(x)
melempar pengecualian.)
Implementor juga harus memastikan bahwa relasi transitif: (x.compareTo(y) > 0 && y.compareTo(z) > 0)
menyiratkan x.compareTo(z) > 0
.
Akhirnya, implementor harus memastikan bahwa x.compareTo(y)==0
menyiratkan bahwa sgn(x.compareTo(z)) == sgn(y.compareTo(z))
, untuk semua z
.
Sangat disarankan, tetapi tidak benar-benar diperlukan bahwa (x.compareTo(y)==0) == (x.equals(y))
. Secara umum, kelas apa pun yang mengimplementasikan Comparable
antarmuka dan melanggar kondisi ini harus dengan jelas menunjukkan fakta ini. Bahasa yang direkomendasikan adalah "Catatan: kelas ini memiliki urutan alami yang tidak konsisten dengan yang sama."
Dalam deskripsi sebelumnya, ekspresi)
notasisgn(
menunjuk fungsi signum matematika, yang didefinisikan untuk mengembalikan salah satu dari -1
, 0
, atau 1
menurut apakah nilai ekspresi negatif, nol, atau positif, masing-masing.
Dokumentasi Java untuk java.lang.Comparable.compareTo(T)
.
Bagian halaman ini adalah modifikasi berdasarkan pekerjaan yang dibuat dan dibagikan oleh Proyek Sumber Terbuka Android dan digunakan sesuai dengan istilah yang dijelaskan dalam Lisensi Atribusi Creative Commons 2.5.