IComparable インターフェイス

定義

[Android.Runtime.Register("java/lang/Comparable", "", "Java.Lang.IComparableInvoker")]
[Java.Interop.JavaTypeParameters(new System.String[] { "T" })]
public interface IComparable : Android.Runtime.IJavaObject, IDisposable, Java.Interop.IJavaPeerable

[<Android.Runtime.Register("java/lang/Comparable", "", "Java.Lang.IComparableInvoker")>]
[<Java.Interop.JavaTypeParameters(new System.String[] { "T" })>]
type IComparable = interface
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable

派生

Android.Content.ComponentName

Android.Content.Res.Configuration

Android.Health.Connect.DataTypes.Units.BloodGlucose

Android.Health.Connect.DataTypes.Units.Energy

Android.Health.Connect.DataTypes.Units.Length

その他…

属性

RegisterAttribute JavaTypeParametersAttribute

実装

IJavaObject IJavaPeerable IDisposable

注釈

このインターフェイスは、それを実装する各クラスのオブジェクトに対して合計順序を設定します。 この順序はクラスの 自然な順序付けと呼ばれ、クラスの compareTo メソッドは 自然な比較メソッドと呼ばれます。

このインターフェイスを実装するオブジェクトのリスト (および配列) は、 Collections#sort(List) Collections.sort (および Arrays#sort(Object[]) Arrays.sort) で自動的に並べ替えることができます。 このインターフェイスを実装するオブジェクトは、比較比較子を指定しなくても、SortedMap の並べ替えられたマップのキーとして、または SortedSet の並べ替えられたセット内の要素として使用できます。

クラス Cの自然な順序は、がクラス e1.compareTo(e2) == 0のすべてのe1.equals(e2)およびe1に対してe2と同じブール値を持つ場合にのみCなされます。 nullはどのクラスのインスタンスでもありません。e.compareTo(null)がNullPointerExceptionを返しても、e.equals(null)はfalseをスローする必要があることに注意してください。

自然な順序が等しいと一致することを強くお勧めします (必須ではありません)。 これは、明示的な比較子を持たない並べ替えられたセット (および並べ替えられたマップ) が、自然な順序が等しい要素 (またはキー) で使用されている場合に "奇妙に" 動作するためです。 特に、このような並べ替えられたセット (または並べ替えられたマップ) は、 equals メソッドの観点から定義される set (または map) の一般的なコントラクトに違反します。

たとえば、明示的な比較子を使用しない並べ替えられたセットにaするように 2 つのキーbと(!a.equals(b) && a.compareTo(b) == 0)を追加した場合、addとaは並べ替えられたセットの観点から等価であるため、2 番目のb操作は false を返します (また、並べ替えられたセットのサイズは増加しません)。

Comparableを実装するほぼすべてのJavaコア クラスには、等しい順序と一致する自然な順序があります。 1 つの例外は java.math.BigDecimalです。java.math.BigDecimal#compareTo の自然な順序は、等しい数値と異なる表現 (4.0 や 4.00 など) を持つ BigDecimal オブジェクトに相当します。 java.math.BigDecimal#equals BigDecimal.equals()が true を返すには、2 つのBigDecimal オブジェクトの表現と数値が同じである必要があります。

数学的に傾斜した場合、指定されたクラス C の自然な順序を定義する 関係 は次のとおりです。

{@code
                  {(x, y) such that x.compareTo(y) <= 0}.
            }

この合計注文の 商 は次のとおりです。

{@code
                  {(x, y) such that x.compareTo(y) == 0}.
            }

これは、商がcompareToの等価関係であり、自然順序がCの合計順序であることをCの契約から直ちに従います。 クラスの自然順序が 等しいと言う場合、自然順序の商はクラスの Object#equals(Object) equals(Object) メソッドによって定義された等価関係であることを意味します。

{(x, y) such that x.equals(y)}.

つまり、クラスの自然な順序が等しい場合、 equals メソッドの等価関係によって定義される等価クラスと、 compareTo メソッドの商によって定義された等価クラスは同じです。

このインターフェイスは、Java コレクション フレームワークのメンバーです。

1.2 で追加されました。

Javaドキュメント。

このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。