Arrays (Connected Device Configuration (CDC), バージョン 1.1.2)

このクラスにある検索メソッドのドキュメントには、「実装」の簡単な説明が含まれています。この説明は、「仕様」の一部ではなく「実装情報」と考えてください。実装者は、仕様に反しないかぎり、ほかのアルゴリズムを自由に使用できます。たとえば、sort(Object[]) が使用するアルゴリズムはマージソートである必要はありませんが、「固定 (stable)」のアルゴリズムでなければいけません。

このクラスは、Java Collections Framework のメンバーです。

導入されたバージョン:: 1.2
関連項目:: Comparable, Comparator

メソッドの概要
`static List`	`asList(Object[] a)` 指定された配列に連動する固定サイズのリストを返します。
`static int`	`binarySearch(byte[] a, byte key)` バイナリサーチアルゴリズムを使用して、指定された byte 値の配列から指定された値を検索します。
`static int`	`binarySearch(char[] a, char key)` バイナリサーチアルゴリズムを使用して、指定された char 値の配列から指定された値を検索します。
`static int`	`binarySearch(double[] a, double key)` バイナリサーチアルゴリズムを使用して、指定された double 値の配列から指定された値を検索します。
`static int`	`binarySearch(float[] a, float key)` バイナリサーチアルゴリズムを使用して、指定された float 値の配列から指定された値を検索します。
`static int`	`binarySearch(int[] a, int key)` バイナリサーチアルゴリズムを使用して、指定された int 値の配列から指定された値を検索します。
`static int`	`binarySearch(long[] a, long key)` バイナリサーチアルゴリズムを使用して、指定された long 値の配列から指定された値を検索します。
`static int`	`binarySearch(Object[] a, Object key)` バイナリサーチアルゴリズムを使用して、指定された配列から指定されたオブジェクトを検索します。
`static int`	`binarySearch(Object[] a, Object key, Comparator c)` バイナリサーチアルゴリズムを使用して、指定された配列から指定されたオブジェクトを検索します。
`static int`	`binarySearch(short[] a, short key)` バイナリサーチアルゴリズムを使用し、指定された short 値の配列から指定された値を検索します。
`static boolean`	`equals(boolean[] a, boolean[] a2)` 指定された 2 つの boolean 値の配列が互いに同等である場合に `true` を返します。
`static boolean`	`equals(byte[] a, byte[] a2)` 指定された 2 つの byte 値の配列が互いに同等である場合に `true` を返します。
`static boolean`	`equals(char[] a, char[] a2)` 指定された 2 つの char 値の配列が互いに同等である場合に `true` を返します。
`static boolean`	`equals(double[] a, double[] a2)` 指定された 2 つの double 値の配列が互いに同等である場合に `true` を返します。
`static boolean`	`equals(float[] a, float[] a2)` 指定された 2 つの float 値の配列が互いに同等である場合に `true` を返します。
`static boolean`	`equals(int[] a, int[] a2)` 指定された 2 つの int 値の配列が互いに同等である場合に `true` を返します。
`static boolean`	`equals(long[] a, long[] a2)` 指定された 2 つの long 値の配列が互いに同等である場合に `true` を返します。
`static boolean`	`equals(Object[] a, Object[] a2)` 指定された 2 つの Object の配列が互いに同等である場合に `true` を返します。
`static boolean`	`equals(short[] a, short[] a2)` 指定された 2 つの short 値の配列が互いに同等である場合に `true` を返します。
`static void`	`fill(boolean[] a, boolean val)` 指定された boolean 値の配列の各要素に、指定された boolean 値を代入します。
`static void`	`fill(boolean[] a, int fromIndex, int toIndex, boolean val)` boolean 値で指定された配列の中で、指定された範囲にある各要素に、指定された boolean 値を割り当てます。
`static void`	`fill(byte[] a, byte val)` 指定された byte 値の配列の各要素に、指定された byte 値を代入します。
`static void`	`fill(byte[] a, int fromIndex, int toIndex, byte val)` byte 値で指定された配列の中で、指定された範囲にある各要素に、指定された byte 値を割り当てます。
`static void`	`fill(char[] a, char val)` 指定された char 値の配列の各要素に、指定された char 値を代入します。
`static void`	`fill(char[] a, int fromIndex, int toIndex, char val)` char 値で指定された配列の中で、指定された範囲にある各要素に、指定された char 値を割り当てます。
`static void`	`fill(double[] a, double val)` 指定された double 値の配列の各要素に、指定された double 値を代入します。
`static void`	`fill(double[] a, int fromIndex, int toIndex, double val)` double 値で指定された配列の中で、指定された範囲にある各要素に、指定された double 値を割り当てます。
`static void`	`fill(float[] a, float val)` 指定された float 値の配列の各要素に、指定された float 値を代入します。
`static void`	`fill(float[] a, int fromIndex, int toIndex, float val)` float 値で指定された配列の中で、指定された範囲にある各要素に、指定された float 値を割り当てます。
`static void`	`fill(int[] a, int val)` 指定された int 値の配列の各要素に、指定された int 値を代入します。
`static void`	`fill(int[] a, int fromIndex, int toIndex, int val)` int 値で指定された配列の中で、指定された範囲にある各要素に、指定された int 値を割り当てます。
`static void`	`fill(long[] a, int fromIndex, int toIndex, long val)` long 値で指定された配列の中で、指定された範囲にある各要素に、指定された long 値を割り当てます。
`static void`	`fill(long[] a, long val)` 指定された long 値の配列の各要素に、指定された long 値を代入します。
`static void`	`fill(Object[] a, int fromIndex, int toIndex, Object val)` 指定された Object の配列で、指定された範囲にある各要素に、指定された Object 参照を代入します。
`static void`	`fill(Object[] a, Object val)` 指定された Object の配列の各要素に、指定された Object 参照を代入します。
`static void`	`fill(short[] a, int fromIndex, int toIndex, short val)` short 値で指定された配列の中で、指定された範囲にある各要素に、指定された short 値を割り当てます。
`static void`	`fill(short[] a, short val)` 指定された short 値の配列の各要素に、指定された short 値を代入します。
`static void`	`sort(byte[] a)` 指定された byte 値の配列を数値の昇順でソートします。
`static void`	`sort(byte[] a, int fromIndex, int toIndex)` 指定された byte 値の配列を数値の昇順でソートします。
`static void`	`sort(char[] a)` 指定された char 値の配列を数値の昇順でソートします。
`static void`	`sort(char[] a, int fromIndex, int toIndex)` 指定された char 値の配列を数値の昇順でソートします。
`static void`	`sort(double[] a)` 指定された double 値の配列を数値の昇順でソートします。
`static void`	`sort(double[] a, int fromIndex, int toIndex)` 指定された double 値の配列を数値の昇順でソートします。
`static void`	`sort(float[] a)` 指定された float 値の配列を数値の昇順でソートします。
`static void`	`sort(float[] a, int fromIndex, int toIndex)` 指定された float 値の配列を数値の昇順でソートします。
`static void`	`sort(int[] a)` 指定された int 値の配列を数値の昇順でソートします。
`static void`	`sort(int[] a, int fromIndex, int toIndex)` 指定された int 値の配列を数値の昇順でソートします。
`static void`	`sort(long[] a)` 指定された long 値の配列を数値の昇順でソートします。
`static void`	`sort(long[] a, int fromIndex, int toIndex)` 指定された long 値の配列を数値の昇順でソートします。
`static void`	`sort(Object[] a)` 要素の「自然順序付け」に従って、指定されたオブジェクトの配列を昇順にソートします。
`static void`	`sort(Object[] a, Comparator c)` 指定されたコンパレータが示す順序に従って、指定されたオブジェクトの配列をソートします。
`static void`	`sort(Object[] a, int fromIndex, int toIndex)` 要素の自然順序付けに従って、指定されたオブジェクトの配列の指定された範囲を昇順でソートします。
`static void`	`sort(Object[] a, int fromIndex, int toIndex, Comparator c)` 指定されたコンパレータの順番に従って、指定されたオブジェクトの配列の指定範囲を昇順でソートします。
`static void`	`sort(short[] a)` 指定された short 値の配列を数値の昇順でソートします。
`static void`	`sort(short[] a, int fromIndex, int toIndex)` 指定された short 値の配列を数値の昇順でソートします。

クラス java.lang.Object から継承されたメソッド
`clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

メソッドの詳細

sort

public static void sort(long[] a)

指定された long 値の配列を数値の昇順でソートします。ソートアルゴリズムは調整されたクイックソートで、『Software-Practice and Experience, Vol. 23(11)』(1993 年 11 月) の 1249 〜 1265 ページの Jon L. Bentley と M. Douglas McIlroy による「Engineering a Sort Function」という記事から応用したものです。このアルゴリズムは、ほかのクイックソートアルゴリズムでは n の 2 乗のパフォーマンスに低下させる多くのデータセットで、n*log(n) のパフォーマンスを提供します。

パラメータ:: a - ソートされる配列

sort

public static void sort(long[] a,
                        int fromIndex,
                        int toIndex)

指定された long 値の配列を数値の昇順でソートします。ソート範囲はインデックス fromIndex (範囲内) からインデックス toIndex (範囲外) となります(fromIndex==toIndex の場合、ソート範囲は空になる)。

ソートアルゴリズムは調整されたクイックソートで、『Software-Practice and Experience, Vol. 23(11)』(1993 年 11 月) の 1249 〜 1265 ページの Jon L. Bentley と M. Douglas McIlroy による「Engineering a Sort Function」という記事から応用したものです。このアルゴリズムは、ほかのクイックソートアルゴリズムでは n の 2 乗のパフォーマンスに低下させる多くのデータセットで、n*log(n) のパフォーマンスを提供します。

パラメータ:: a - ソートされる配列; fromIndex - ソートされる最初の要素 (範囲内) のインデックス; toIndex - ソートされる最後の要素 (範囲外) のインデックス
例外:: IllegalArgumentException - fromIndex > toIndex の場合; ArrayIndexOutOfBoundsException - fromIndex < 0 または toIndex > a.length の場合

sort

public static void sort(int[] a)

指定された int 値の配列を数値の昇順でソートします。ソートアルゴリズムは調整されたクイックソートで、『Software-Practice and Experience, Vol. 23(11)』(1993 年 11 月) の 1249 〜 1265 ページの Jon L. Bentley と M. Douglas McIlroy による「Engineering a Sort Function」という記事から応用したものです。このアルゴリズムは、ほかのクイックソートアルゴリズムでは n の 2 乗のパフォーマンスに低下させる多くのデータセットで、n*log(n) のパフォーマンスを提供します。

パラメータ:: a - ソートされる配列

sort

public static void sort(int[] a,
                        int fromIndex,
                        int toIndex)

指定された int 値の配列を数値の昇順でソートします。ソート範囲はインデックス fromIndex (範囲内) からインデックス toIndex (範囲外) となります(fromIndex==toIndex の場合、ソート範囲は空になる)。

パラメータ:: a - ソートされる配列; fromIndex - ソートされる最初の要素 (範囲内) のインデックス; toIndex - ソートされる最後の要素 (範囲外) のインデックス
例外:: IllegalArgumentException - fromIndex > toIndex の場合; ArrayIndexOutOfBoundsException - fromIndex < 0 または toIndex > a.length の場合

sort

public static void sort(short[] a)

指定された short 値の配列を数値の昇順でソートします。ソートアルゴリズムは調整されたクイックソートで、『Software-Practice and Experience, Vol. 23(11)』(1993 年 11 月) の 1249 〜 1265 ページの Jon L. Bentley と M. Douglas McIlroy による「Engineering a Sort Function」という記事から応用したものです。このアルゴリズムは、ほかのクイックソートアルゴリズムでは n の 2 乗のパフォーマンスに低下させる多くのデータセットで、n*log(n) のパフォーマンスを提供します。

パラメータ:: a - ソートされる配列

sort

public static void sort(short[] a,
                        int fromIndex,
                        int toIndex)

指定された short 値の配列を数値の昇順でソートします。ソート範囲はインデックス fromIndex (範囲内) からインデックス toIndex (範囲外) となります(fromIndex==toIndex の場合、ソート範囲は空になる)。

パラメータ:: a - ソートされる配列; fromIndex - ソートされる最初の要素 (範囲内) のインデックス; toIndex - ソートされる最後の要素 (範囲外) のインデックス
例外:: IllegalArgumentException - fromIndex > toIndex の場合; ArrayIndexOutOfBoundsException - fromIndex < 0 または toIndex > a.length の場合

sort

public static void sort(char[] a)

指定された char 値の配列を数値の昇順でソートします。ソートアルゴリズムは調整されたクイックソートで、『Software-Practice and Experience, Vol. 23(11)』(1993 年 11 月) の 1249 〜 1265 ページの Jon L. Bentley と M. Douglas McIlroy による「Engineering a Sort Function」という記事から応用したものです。このアルゴリズムは、ほかのクイックソートアルゴリズムでは n の 2 乗のパフォーマンスに低下させる多くのデータセットで、n*log(n) のパフォーマンスを提供します。

パラメータ:: a - ソートされる配列

sort

public static void sort(char[] a,
                        int fromIndex,
                        int toIndex)

指定された char 値の配列を数値の昇順でソートします。ソート範囲はインデックス fromIndex (範囲内) からインデックス toIndex (範囲外) となります(fromIndex==toIndex の場合、ソート範囲は空になる)。

パラメータ:: a - ソートされる配列; fromIndex - ソートされる最初の要素 (範囲内) のインデックス; toIndex - ソートされる最後の要素 (範囲外) のインデックス
例外:: IllegalArgumentException - fromIndex > toIndex の場合; ArrayIndexOutOfBoundsException - fromIndex < 0 または toIndex > a.length の場合

sort

public static void sort(byte[] a)

指定された byte 値の配列を数値の昇順でソートします。ソートアルゴリズムは調整されたクイックソートで、『Software-Practice and Experience, Vol. 23(11)』(1993 年 11 月) の 1249 〜 1265 ページの Jon L. Bentley と M. Douglas McIlroy による「Engineering a Sort Function」という記事から応用したものです。このアルゴリズムは、ほかのクイックソートアルゴリズムでは n の 2 乗のパフォーマンスに低下させる多くのデータセットで、n*log(n) のパフォーマンスを提供します。

パラメータ:: a - ソートされる配列

sort

public static void sort(byte[] a,
                        int fromIndex,
                        int toIndex)

指定された byte 値の配列を数値の昇順でソートします。ソート範囲はインデックス fromIndex (範囲内) からインデックス toIndex (範囲外) となります(fromIndex==toIndex の場合、ソート範囲は空になる)。

パラメータ:: a - ソートされる配列; fromIndex - ソートされる最初の要素 (範囲内) のインデックス; toIndex - ソートされる最後の要素 (範囲外) のインデックス
例外:: IllegalArgumentException - fromIndex > toIndex の場合; ArrayIndexOutOfBoundsException - fromIndex < 0 または toIndex > a.length の場合

sort

public static void sort(double[] a)

指定された double 値の配列を数値の昇順でソートします。

< のリレーションは、すべての浮動小数点値に関する全体順序付けを提供しません。この浮動小数点値は絶対値が異なる数値ですが、-0.0 == 0.0 は true であり、NaN 値はあらゆる浮動小数点値やそれ自体と比較しても、それ以下でも以上でも等値でもありません。ソートを進行させるために、このメソッドは数値の昇順を確定する < リレーションを使用する代わりに、Double.compareTo(java.lang.Double) が行う全体順序付けを使用します。-0.0 が 0.0 未満として扱われ、NaN がほかの浮動小数点値より大きいとみなされる点で、この順序付けは、< リレーションとは異なります。ソートを行うために、すべての NaN 値は等価とみなされます。

パラメータ:: a - ソートされる配列

sort

public static void sort(double[] a,
                        int fromIndex,
                        int toIndex)

指定された double 値の配列を数値の昇順でソートします。ソート範囲はインデックス fromIndex (範囲内) からインデックス toIndex (範囲外) となります(fromIndex==toIndex の場合、ソート範囲は空になる)。

パラメータ:: a - ソートされる配列; fromIndex - ソートされる最初の要素 (範囲内) のインデックス; toIndex - ソートされる最後の要素 (範囲外) のインデックス
例外:: IllegalArgumentException - fromIndex > toIndex の場合; ArrayIndexOutOfBoundsException - fromIndex < 0 または toIndex > a.length の場合

sort

public static void sort(float[] a)

指定された float 値の配列を数値の昇順でソートします。

< のリレーションは、すべての浮動小数点値に関する全体順序付けを提供しません。この浮動小数点値は絶対値が異なる数値ですが、-0.0f == 0.0f は true であり、NaN 値はあらゆる浮動小数点値やそれ自体と比較しても、それ以下でも以上でも等値でもありません。ソートを進行させるために、このメソッドは数値の昇順を確定する < リレーションを使用する代わりに、Float.compareTo(java.lang.Float) が行う全体順序付けを使用します。-0.0f が 0.0f 未満として扱われ、NaN がほかの浮動小数点値より大きいとみなされる点で、この順序付けは、< リレーションとは異なります。ソートを行うために、すべての NaN 値は等価とみなされます。

パラメータ:: a - ソートされる配列

sort

public static void sort(float[] a,
                        int fromIndex,
                        int toIndex)

指定された float 値の配列を数値の昇順でソートします。ソート範囲はインデックス fromIndex (範囲内) からインデックス toIndex (範囲外) となります(fromIndex==toIndex の場合、ソート範囲は空になる)。

パラメータ:: a - ソートされる配列; fromIndex - ソートされる最初の要素 (範囲内) のインデックス; toIndex - ソートされる最後の要素 (範囲外) のインデックス
例外:: IllegalArgumentException - fromIndex > toIndex の場合; ArrayIndexOutOfBoundsException - fromIndex < 0 または toIndex > a.length の場合

sort

public static void sort(Object[] a)

要素の「自然順序付け」に従って、指定されたオブジェクトの配列を昇順にソートします。配列のすべての要素は、Comparable インタフェースを実装している必要があります。また、配列のすべての要素は、「相互に比較可能」でなければいけません。つまり、配列の要素が e1 および e2 の場合に、e1.compareTo(e2) で ClassCastException をスローするべきではありません。

このソートは固定であることが保証されています。つまり、ソートを実行しても、同等の要素の順序は変わりません。

ソートアルゴリズムは修正マージソートです。このソートでは、下位のサブリストでの最高レベルの要素が上位のサブリストでの最低レベルの要素より小さい場合、マージは省略されます。このアルゴリズムは、常に n*log(n) のパフォーマンスを提供します。

パラメータ:: a - ソートされる配列
例外:: ClassCastException - 配列に「相互に比較可能」でない要素 (たとえば、文字列と整数) がある場合
関連項目:: Comparable

sort

public static void sort(Object[] a,
                        int fromIndex,
                        int toIndex)

要素の自然順序付けに従って、指定されたオブジェクトの配列の指定された範囲を昇順でソートします。ソート範囲はインデックス fromIndex (範囲内) からインデックス toIndex (範囲外) となります(fromIndex==toIndex の場合、ソート範囲は空になる)。この範囲内のすべての要素は、Comparable インタフェースを実装している必要があります。また、範囲のすべての要素は、「相互に比較可能」でなければいけません。つまり、配列の要素が e1 および e2 である場合に、e1.compareTo(e2) で ClassCastException をスローするべきではありません。

このソートは固定であることが保証されています。つまり、ソートを実行しても、同等の要素の順序は変わりません。

パラメータ:: a - ソートされる配列; fromIndex - ソートされる最初の要素 (範囲内) のインデックス; toIndex - ソートされる最後の要素 (範囲外) のインデックス
例外:: IllegalArgumentException - fromIndex > toIndex の場合; ArrayIndexOutOfBoundsException - fromIndex < 0 または toIndex > a.length の場合; ClassCastException - 配列に「相互に比較可能」でない要素 (たとえば、文字列と整数) がある場合
関連項目:: Comparable

sort

public static void sort(Object[] a,
                        Comparator c)

指定されたコンパレータが示す順序に従って、指定されたオブジェクトの配列をソートします。配列のすべての要素は、指定されたコンパレータで「相互に比較可能」でなければいけません。つまり、配列の要素が e1 および e2 の場合、c.compare(e1, e2) で ClassCastException をスローするべきではありません。

このソートは固定であることが保証されています。つまり、ソートを実行しても、同等の要素の順序は変わりません。

パラメータ:: a - ソートされる配列; c - 配列の順序を決定するコンパレータ。null 値は、要素の「自然順序付け」を使用することを示す
例外:: ClassCastException - 指定されたコンパレータで「相互に比較」できない要素が配列にある場合
関連項目:: Comparator

sort

public static void sort(Object[] a,
                        int fromIndex,
                        int toIndex,
                        Comparator c)

指定されたコンパレータの順番に従って、指定されたオブジェクトの配列の指定範囲を昇順でソートします。ソート範囲はインデックス fromIndex (範囲内) からインデックス toIndex (範囲外) となります(fromIndex==toIndex の場合、ソート範囲は空になる)。この範囲のすべての要素は、指定されたコンパレータで「相互に比較可能」でなければいけません。つまり、配列の要素が e1 および e2 の場合、c.compare(e1, e2) で ClassCastException をスローするべきではありません。

このソートは固定であることが保証されています。つまり、ソートを実行しても、同等の要素の順序は変わりません。

パラメータ:: a - ソートされる配列; fromIndex - ソートされる最初の要素 (範囲内) のインデックス; toIndex - ソートされる最後の要素 (範囲外) のインデックス; c - 配列の順序を決定するコンパレータ。null 値は、要素の「自然順序付け」を使用することを示す
例外:: ClassCastException - 指定されたコンパレータで「相互に比較」できない要素が配列にある場合; IllegalArgumentException - fromIndex > toIndex の場合; ArrayIndexOutOfBoundsException - fromIndex < 0 または toIndex > a.length の場合
関連項目:: Comparator

binarySearch

public static int binarySearch(long[] a,
                               long key)

バイナリサーチアルゴリズムを使用して、指定された long 値の配列から指定された値を検索します。この呼び出しの前に、前述の sort メソッドで範囲をソートしてください。リストがソートされていない場合、結果は定義されません。指定された値を持つ要素が配列に複数ある場合には、どれが検索されるかについての保証はありません。

パラメータ:: a - 検索される配列; key - 検索される値
戻り値:: リストに検索キーが含まれている場合は、その検索キーのインデックス。そうでない場合は (-(挿入ポイント) - 1)。「挿入ポイント」は、リスト内のキーが挿入されるポイントとして定義される。つまり、キーより大きな最初の要素のインデックスか、リスト内のすべての要素が指定されたキーより小さい場合は list.size()。これにより、キーが見つかった場合にだけ戻り値が >= 0 になることが保証される
関連項目:: sort(long[])

binarySearch

public static int binarySearch(int[] a,
                               int key)

バイナリサーチアルゴリズムを使用して、指定された int 値の配列から指定された値を検索します。この呼び出しの前に、前述の sort メソッドで範囲をソートしてください。リストがソートされていない場合、結果は定義されません。指定された値を持つ要素が配列に複数ある場合には、どれが検索されるかについての保証はありません。

パラメータ:: a - 検索される配列; key - 検索される値
戻り値:: リストに検索キーが含まれている場合は、その検索キーのインデックス。そうでない場合は (-(挿入ポイント) - 1)。「挿入ポイント」は、リスト内のキーが挿入されるポイントとして定義される。つまり、キーより大きな最初の要素のインデックスか、リスト内のすべての要素が指定されたキーより小さい場合は list.size()。これにより、キーが見つかった場合にだけ戻り値が >= 0 になることが保証される
関連項目:: sort(int[])

binarySearch

public static int binarySearch(short[] a,
                               short key)

バイナリサーチアルゴリズムを使用し、指定された short 値の配列から指定された値を検索します。この呼び出しの前に、前述の sort メソッドで範囲をソートしてください。リストがソートされていない場合、結果は定義されません。指定された値を持つ要素が配列に複数ある場合には、どれが検索されるかについての保証はありません。

パラメータ:: a - 検索される配列; key - 検索される値
戻り値:: リストに検索キーが含まれている場合は、その検索キーのインデックス。そうでない場合は (-(挿入ポイント) - 1)。「挿入ポイント」は、リスト内のキーが挿入されるポイントとして定義される。つまり、キーより大きな最初の要素のインデックスか、リスト内のすべての要素が指定されたキーより小さい場合は list.size()。これにより、キーが見つかった場合にだけ戻り値が >= 0 になることが保証される
関連項目:: sort(short[])

binarySearch

public static int binarySearch(char[] a,
                               char key)

バイナリサーチアルゴリズムを使用して、指定された char 値の配列から指定された値を検索します。この呼び出しの前に、前述の sort メソッドで範囲をソートしてください。リストがソートされていない場合、結果は定義されません。指定された値を持つ要素が配列に複数ある場合には、どれが検索されるかについての保証はありません。

パラメータ:: a - 検索される配列; key - 検索される値
戻り値:: リストに検索キーが含まれている場合は、その検索キーのインデックス。そうでない場合は (-(挿入ポイント) - 1)。「挿入ポイント」は、リスト内のキーが挿入されるポイントとして定義される。つまり、キーより大きな最初の要素のインデックスか、リスト内のすべての要素が指定されたキーより小さい場合は list.size()。これにより、キーが見つかった場合にだけ戻り値が >= 0 になることが保証される
関連項目:: sort(char[])

binarySearch

public static int binarySearch(byte[] a,
                               byte key)

バイナリサーチアルゴリズムを使用して、指定された byte 値の配列から指定された値を検索します。この呼び出しの前に、前述の sort メソッドで範囲をソートしてください。リストがソートされていない場合、結果は定義されません。指定された値を持つ要素が配列に複数ある場合には、どれが検索されるかについての保証はありません。

パラメータ:: a - 検索される配列; key - 検索される値
戻り値:: リストに検索キーが含まれている場合は、その検索キーのインデックス。そうでない場合は (-(挿入ポイント) - 1)。「挿入ポイント」は、リスト内のキーが挿入されるポイントとして定義される。つまり、キーより大きな最初の要素のインデックスか、リスト内のすべての要素が指定されたキーより小さい場合は list.size()。これにより、キーが見つかった場合にだけ戻り値が >= 0 になることが保証される
関連項目:: sort(byte[])

binarySearch

public static int binarySearch(double[] a,
                               double key)

バイナリサーチアルゴリズムを使用して、指定された double 値の配列から指定された値を検索します。この呼び出しの前に、前述の sort メソッドで範囲をソートしてください。リストがソートされていない場合、結果は定義されません。指定された値を持つ要素が配列に複数ある場合には、どれが検索されるかについての保証はありません。このメソッドではすべての NaN 値を等価とみなします。

パラメータ:: a - 検索される配列; key - 検索される値
戻り値:: リストに検索キーが含まれている場合は、その検索キーのインデックス。そうでない場合は (-(挿入ポイント) - 1)。「挿入ポイント」は、リスト内のキーが挿入されるポイントとして定義される。つまり、キーより大きな最初の要素のインデックスか、リスト内のすべての要素が指定されたキーより小さい場合は list.size()。これにより、キーが見つかった場合にだけ戻り値が >= 0 になることが保証される
関連項目:: sort(double[])

binarySearch

public static int binarySearch(float[] a,
                               float key)

バイナリサーチアルゴリズムを使用して、指定された float 値の配列から指定された値を検索します。この呼び出しの前に、前述の sort メソッドで範囲をソートしてください。リストがソートされていない場合、結果は定義されません。指定された値を持つ要素が配列に複数ある場合には、どれが検索されるかについての保証はありません。このメソッドではすべての NaN 値を等価とみなします。

パラメータ:: a - 検索される配列; key - 検索される値
戻り値:: リストに検索キーが含まれている場合は、その検索キーのインデックス。そうでない場合は (-(挿入ポイント) - 1)。「挿入ポイント」は、リスト内のキーが挿入されるポイントとして定義される。つまり、キーより大きな最初の要素のインデックスか、リスト内のすべての要素が指定されたキーより小さい場合は list.size()。これにより、キーが見つかった場合にだけ戻り値が >= 0 になることが保証される
関連項目:: sort(float[])

binarySearch

public static int binarySearch(Object[] a,
                               Object key)

バイナリサーチアルゴリズムを使用して、指定された配列から指定されたオブジェクトを検索します。配列は、この呼び出しの前に前述の Sort(Object[]) を使用して、要素の自然順序付けに従って昇順にソートしてください。リストがソートされていない場合、結果は定義されません。配列が相互に比較可能でない要素、たとえば文字列や整数などである場合、配列はその要素の自然順序付けに従ってソートできず、結果は未定義です。指定されたオブジェクトと同等の要素が配列に複数ある場合には、どれが検索されるかについての保証はありません。

パラメータ:: a - 検索される配列; key - 検索される値
戻り値:: リストに検索キーが含まれている場合は、その検索キーのインデックス。そうでない場合は (-(挿入ポイント) - 1)。「挿入ポイント」は、リスト内のキーが挿入されるポイントとして定義される。つまり、キーより大きな最初の要素のインデックスか、リスト内のすべての要素が指定されたキーより小さい場合は list.size()。これにより、キーが見つかった場合にだけ戻り値が >= 0 になることが保証される
例外:: ClassCastException - 検索キーが配列の要素と比較可能でない場合
関連項目:: Comparable, sort(Object[])

binarySearch

public static int binarySearch(Object[] a,
                               Object key,
                               Comparator c)

バイナリサーチアルゴリズムを使用して、指定された配列から指定されたオブジェクトを検索します。配列は、この呼び出しの前に前述の Sort(Object[], Comparator) メソッドを使用して、指定されたコンパレータに従って昇順にソートしてください。リストがソートされていない場合、結果は定義されません。指定されたオブジェクトと同等の要素が配列に複数ある場合には、どれが検索されるかについての保証はありません。

パラメータ:: a - 検索される配列; key - 検索される値; c - 配列が順序付けされるコンパレータ。null 値は、要素の「自然順序付け」を使用することを示す
戻り値:: リストに検索キーが含まれている場合は、その検索キーのインデックス。そうでない場合は (-(挿入ポイント) - 1)。「挿入ポイント」は、リスト内のキーが挿入されるポイントとして定義される。つまり、キーより大きな最初の要素のインデックスか、リスト内のすべての要素が指定されたキーより小さい場合は list.size()。これにより、キーが見つかった場合にだけ戻り値が >= 0 になることが保証される
例外:: ClassCastException - 指定されたコンパレータで「相互に比較可能」でない要素が配列に含まれている場合、あるいは検索キーがこのコンパレータで配列の要素と相互に比較できない場合
関連項目:: Comparable, sort(Object[], Comparator)

equals

public static boolean equals(long[] a,
                             long[] a2)

指定された 2 つの long 値の配列が互いに同等である場合に true を返します。2 つの配列が同等とみなされるのは、両方の配列に同じ数の要素があり、対応する対の要素がすべて同等である場合です。つまり、同じ順序で同じ要素がある 2 つの配列は同等です。また、2 つの配列参照が null の場合にも同等とみなされます。

パラメータ:: a - 同等であるかどうかを判定する 1 つ目の配列; a2 - 同等であるかどうかを判定する 2 つ目の配列
戻り値:: 2 つの配列が同等である場合は true

equals

public static boolean equals(int[] a,
                             int[] a2)

指定された 2 つの int 値の配列が互いに同等である場合に true を返します。2 つの配列が同等とみなされるのは、両方の配列に同じ数の要素があり、対応する対の要素がすべて同等である場合です。つまり、同じ順序で同じ要素がある 2 つの配列は同等です。また、2 つの配列参照が null の場合にも同等とみなされます。

パラメータ:: a - 同等であるかどうかを判定する 1 つ目の配列; a2 - 同等であるかどうかを判定する 2 つ目の配列
戻り値:: 2 つの配列が同等である場合は true

equals

public static boolean equals(short[] a,
                             short[] a2)

指定された 2 つの short 値の配列が互いに同等である場合に true を返します。2 つの配列が同等とみなされるのは、両方の配列に同じ数の要素があり、対応する対の要素がすべて同等である場合です。つまり、同じ順序で同じ要素がある 2 つの配列は同等です。また、2 つの配列参照が null の場合にも同等とみなされます。

パラメータ:: a - 同等であるかどうかを判定する 1 つ目の配列; a2 - 同等であるかどうかを判定する 2 つ目の配列
戻り値:: 2 つの配列が同等である場合は true

equals

public static boolean equals(char[] a,
                             char[] a2)

指定された 2 つの char 値の配列が互いに同等である場合に true を返します。2 つの配列が同等とみなされるのは、両方の配列に同じ数の要素があり、対応する対の要素がすべて同等である場合です。つまり、同じ順序で同じ要素がある 2 つの配列は同等です。また、2 つの配列参照が null の場合にも同等とみなされます。

パラメータ:: a - 同等であるかどうかを判定する 1 つ目の配列; a2 - 同等であるかどうかを判定する 2 つ目の配列
戻り値:: 2 つの配列が同等である場合は true

equals

public static boolean equals(byte[] a,
                             byte[] a2)

指定された 2 つの byte 値の配列が互いに同等である場合に true を返します。2 つの配列が同等とみなされるのは、両方の配列に同じ数の要素があり、対応する対の要素がすべて同等である場合です。つまり、同じ順序で同じ要素がある 2 つの配列は同等です。また、2 つの配列参照が null の場合にも同等とみなされます。

パラメータ:: a - 同等であるかどうかを判定する 1 つ目の配列; a2 - 同等であるかどうかを判定する 2 つ目の配列
戻り値:: 2 つの配列が同等である場合は true

equals

public static boolean equals(boolean[] a,
                             boolean[] a2)

指定された 2 つの boolean 値の配列が互いに同等である場合に true を返します。2 つの配列が同等とみなされるのは、両方の配列に同じ数の要素があり、対応する対の要素がすべて同等である場合です。つまり、同じ順序で同じ要素がある 2 つの配列は同等です。また、2 つの配列参照が null の場合にも同等とみなされます。

パラメータ:: a - 同等であるかどうかを判定する 1 つ目の配列; a2 - 同等であるかどうかを判定する 2 つ目の配列
戻り値:: 2 つの配列が同等である場合は true

equals

public static boolean equals(double[] a,
                             double[] a2)

指定された 2 つの double 値の配列が互いに同等である場合に true を返します。2 つの配列が同等とみなされるのは、両方の配列に同じ数の要素があり、対応する対の要素がすべて同等である場合です。つまり、同じ順序で同じ要素がある 2 つの配列は同等です。また、2 つの配列参照が null の場合にも同等とみなされます。

2 つの double 値 d1 と d2 は、次の場合に同等とみなされます。

    new Double(d1).equals(new Double(d2))

== 演算子と違って、このメソッドは NaN をそれ自身と同等と見なし、0.0d と -0.0d は同等と見なしません。

パラメータ:: a - 同等であるかどうかを判定する 1 つ目の配列; a2 - 同等であるかどうかを判定する 2 つ目の配列
戻り値:: 2 つの配列が同等である場合は true
関連項目:: Double.equals(Object)

equals

public static boolean equals(float[] a,
                             float[] a2)

指定された 2 つの float 値の配列が互いに同等である場合に true を返します。2 つの配列が同等とみなされるのは、両方の配列に同じ数の要素があり、対応する対の要素がすべて同等である場合です。つまり、同じ順序で同じ要素がある 2 つの配列は同等です。また、2 つの配列参照が null の場合にも同等とみなされます。

次の場合において、2 つの float 値 f1 および f2 は同等となります。

    new Float(f1).equals(new Float(f2))

==演算子と違って、このメソッドは NaN をそれ自身と同等と見なし、0.0f と -0.0f は同等と見なしません。

パラメータ:: a - 同等であるかどうかを判定する 1 つ目の配列; a2 - 同等であるかどうかを判定する 2 つ目の配列
戻り値:: 2 つの配列が同等である場合は true
関連項目:: Float.equals(Object)

equals

public static boolean equals(Object[] a,
                             Object[] a2)

指定された 2 つの Object の配列が互いに同等である場合に true を返します。2 つの配列が同等とみなされるのは、両方の配列に同じ数の要素があり、対応する対の要素がすべて同等である場合です。e1 と e2 の 2 つのオブジェクトは、(e1==null ? e2==null :e1.equals(e2)) の場合に同等とみなされます。つまり、同じ順序で同じ要素がある 2 つの配列は同等です。また、2 つの配列参照が null の場合にも同等とみなされます。

パラメータ:: a - 同等であるかどうかを判定する 1 つ目の配列; a2 - 同等であるかどうかを判定する 2 つ目の配列
戻り値:: 2 つの配列が同等である場合は true

fill

public static void fill(long[] a,
                        long val)

指定された long 値の配列の各要素に、指定された long 値を代入します。

パラメータ:: a - 値を代入する配列; val - 配列のすべての要素に格納する値

fill

public static void fill(long[] a,
                        int fromIndex,
                        int toIndex,
                        long val)

long 値で指定された配列の中で、指定された範囲にある各要素に、指定された long 値を割り当てます。値を代入する範囲はインデックス fromIndex (範囲内) からインデックス toIndex (範囲外) となります。fromIndex==toIndex の場合、値を代入する範囲は空になります。

パラメータ:: a - 値を代入する配列; fromIndex - 指定された値を代入する最初の要素 (範囲内) のインデックス; toIndex - 指定された値を代入する最後の要素 (範囲外) のインデックス; val - 配列のすべての要素に格納する値
例外:: IllegalArgumentException - fromIndex > toIndex の場合; ArrayIndexOutOfBoundsException - fromIndex < 0 または toIndex > a.length の場合

fill

public static void fill(int[] a,
                        int val)

指定された int 値の配列の各要素に、指定された int 値を代入します。

パラメータ:: a - 値を代入する配列; val - 配列のすべての要素に格納する値

fill

public static void fill(int[] a,
                        int fromIndex,
                        int toIndex,
                        int val)

int 値で指定された配列の中で、指定された範囲にある各要素に、指定された int 値を割り当てます。値を代入する範囲はインデックス fromIndex (範囲内) からインデックス toIndex (範囲外) となります。fromIndex==toIndex の場合、値を代入する範囲は空になります。

パラメータ:: a - 値を代入する配列; fromIndex - 指定された値を代入する最初の要素 (範囲内) のインデックス; toIndex - 指定された値を代入する最後の要素 (範囲外) のインデックス; val - 配列のすべての要素に格納する値
例外:: IllegalArgumentException - fromIndex > toIndex の場合; ArrayIndexOutOfBoundsException - fromIndex < 0 または toIndex > a.length の場合

fill

public static void fill(short[] a,
                        short val)

指定された short 値の配列の各要素に、指定された short 値を代入します。

パラメータ:: a - 値を代入する配列; val - 配列のすべての要素に格納する値

fill

public static void fill(short[] a,
                        int fromIndex,
                        int toIndex,
                        short val)

short 値で指定された配列の中で、指定された範囲にある各要素に、指定された short 値を割り当てます。値を代入する範囲はインデックス fromIndex (範囲内) からインデックス toIndex (範囲外) となります。fromIndex==toIndex の場合、値を代入する範囲は空になります。

パラメータ:: a - 値を代入する配列; fromIndex - 指定された値を代入する最初の要素 (範囲内) のインデックス; toIndex - 指定された値を代入する最後の要素 (範囲外) のインデックス; val - 配列のすべての要素に格納する値
例外:: IllegalArgumentException - fromIndex > toIndex の場合; ArrayIndexOutOfBoundsException - fromIndex < 0 または toIndex > a.length の場合

fill

public static void fill(char[] a,
                        char val)

指定された char 値の配列の各要素に、指定された char 値を代入します。

パラメータ:: a - 値を代入する配列; val - 配列のすべての要素に格納する値

fill

public static void fill(char[] a,
                        int fromIndex,
                        int toIndex,
                        char val)

char 値で指定された配列の中で、指定された範囲にある各要素に、指定された char 値を割り当てます。値を代入する範囲はインデックス fromIndex (範囲内) からインデックス toIndex (範囲外) となります。fromIndex==toIndex の場合、値を代入する範囲は空になります。

パラメータ:: a - 値を代入する配列; fromIndex - 指定された値を代入する最初の要素 (範囲内) のインデックス; toIndex - 指定された値を代入する最後の要素 (範囲外) のインデックス; val - 配列のすべての要素に格納する値
例外:: IllegalArgumentException - fromIndex > toIndex の場合; ArrayIndexOutOfBoundsException - fromIndex < 0 または toIndex > a.length の場合

fill

public static void fill(byte[] a,
                        byte val)

指定された byte 値の配列の各要素に、指定された byte 値を代入します。

パラメータ:: a - 値を代入する配列; val - 配列のすべての要素に格納する値

fill

public static void fill(byte[] a,
                        int fromIndex,
                        int toIndex,
                        byte val)

byte 値で指定された配列の中で、指定された範囲にある各要素に、指定された byte 値を割り当てます。値を代入する範囲はインデックス fromIndex (範囲内) からインデックス toIndex (範囲外) となります。fromIndex==toIndex の場合、値を代入する範囲は空になります。

パラメータ:: a - 値を代入する配列; fromIndex - 指定された値を代入する最初の要素 (範囲内) のインデックス; toIndex - 指定された値を代入する最後の要素 (範囲外) のインデックス; val - 配列のすべての要素に格納する値
例外:: IllegalArgumentException - fromIndex > toIndex の場合; ArrayIndexOutOfBoundsException - fromIndex < 0 または toIndex > a.length の場合

fill

public static void fill(boolean[] a,
                        boolean val)

指定された boolean 値の配列の各要素に、指定された boolean 値を代入します。

パラメータ:: a - 値を代入する配列; val - 配列のすべての要素に格納する値

fill

public static void fill(boolean[] a,
                        int fromIndex,
                        int toIndex,
                        boolean val)

boolean 値で指定された配列の中で、指定された範囲にある各要素に、指定された boolean 値を割り当てます。値を代入する範囲はインデックス fromIndex (範囲内) から toIndex (範囲外) となります。fromIndex==toIndex の場合、代入する範囲は空になります。

パラメータ:: a - 値を代入する配列; fromIndex - 指定された値を代入する最初の要素 (範囲内) のインデックス; toIndex - 指定された値を代入する最後の要素 (範囲外) のインデックス; val - 配列のすべての要素に格納する値
例外:: IllegalArgumentException - fromIndex > toIndex の場合; ArrayIndexOutOfBoundsException - fromIndex < 0 または toIndex > a.length の場合

fill

public static void fill(double[] a,
                        double val)

指定された double 値の配列の各要素に、指定された double 値を代入します。

パラメータ:: a - 値を代入する配列; val - 配列のすべての要素に格納する値

fill

public static void fill(double[] a,
                        int fromIndex,
                        int toIndex,
                        double val)

double 値で指定された配列の中で、指定された範囲にある各要素に、指定された double 値を割り当てます。値を代入する範囲はインデックス fromIndex (範囲内) からインデックス toIndex (範囲外) となります。fromIndex==toIndex の場合、値を代入する範囲は空になります。

パラメータ:: a - 値を代入する配列; fromIndex - 指定された値を代入する最初の要素 (範囲内) のインデックス; toIndex - 指定された値を代入する最後の要素 (範囲外) のインデックス; val - 配列のすべての要素に格納する値
例外:: IllegalArgumentException - fromIndex > toIndex の場合; ArrayIndexOutOfBoundsException - fromIndex < 0 または toIndex > a.length の場合

fill

public static void fill(float[] a,
                        float val)

指定された float 値の配列の各要素に、指定された float 値を代入します。

パラメータ:: a - 値を代入する配列; val - 配列のすべての要素に格納する値

fill

public static void fill(float[] a,
                        int fromIndex,
                        int toIndex,
                        float val)

float 値で指定された配列の中で、指定された範囲にある各要素に、指定された float 値を割り当てます。値を代入する範囲はインデックス fromIndex (範囲内) からインデックス toIndex (範囲外) となります。fromIndex==toIndex の場合、値を代入する範囲は空になります。

パラメータ:: a - 値を代入する配列; fromIndex - 指定された値を代入する最初の要素 (範囲内) のインデックス; toIndex - 指定された値を代入する最後の要素 (範囲外) のインデックス; val - 配列のすべての要素に格納する値
例外:: IllegalArgumentException - fromIndex > toIndex の場合; ArrayIndexOutOfBoundsException - fromIndex < 0 または toIndex > a.length の場合

fill

public static void fill(Object[] a,
                        Object val)

指定された Object の配列の各要素に、指定された Object 参照を代入します。

パラメータ:: a - 値を代入する配列; val - 配列のすべての要素に格納する値

fill

public static void fill(Object[] a,
                        int fromIndex,
                        int toIndex,
                        Object val)

指定された Object の配列で、指定された範囲にある各要素に、指定された Object 参照を代入します。値を代入する範囲はインデックス fromIndex (範囲内) からインデックス toIndex (範囲外) となります。fromIndex==toIndex の場合、値を代入する範囲は空になります。

パラメータ:: a - 値を代入する配列; fromIndex - 指定された値を代入する最初の要素 (範囲内) のインデックス; toIndex - 指定された値を代入する最後の要素 (範囲外) のインデックス; val - 配列のすべての要素に格納する値
例外:: IllegalArgumentException - fromIndex > toIndex の場合; ArrayIndexOutOfBoundsException - fromIndex < 0 または toIndex > a.length の場合

asList

public static List asList(Object[] a)

指定された配列に連動する固定サイズのリストを返します。返されたリストへの変更は、そのまま配列に書き込まれます。このメソッドは、Collection.toArray と組み合わせることで、配列ベースの API とコレクションベースの API の橋渡し役として機能します。また、返されるリストは直列化可能で、RandomAccess を実装します。

パラメータ:: a - リストの基となる配列
戻り値:: 指定された配列のリスト表示
関連項目:: Collection.toArray()

概要

パッケージ

クラス

使用

階層ツリー

非推奨 API

索引

ヘルプ

CDC 1.1.2

前のクラス 次のクラス

フレームあり フレームなし

概要: 入れ子 | フィールド | コンストラクタ | メソッド

詳細: フィールド | コンストラクタ | メソッド

java.util クラス Arrays

sort

sort

sort

sort

sort

sort

sort

sort

sort

sort

sort

sort

sort

sort

sort

sort

sort

sort

binarySearch

binarySearch

binarySearch

binarySearch

binarySearch

binarySearch

binarySearch

binarySearch

binarySearch

equals

equals

equals

equals

equals

equals

equals

equals

equals

fill

fill

fill

fill

fill

fill

fill

fill

fill

fill

fill

fill

fill

fill

fill

fill

fill

fill

asList

java.util
クラス Arrays