Arrays (Java 2 Platform SE 5.0)

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

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

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

メソッドの概要

static



<T> List<T>

asList(T... 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(short[] a, short key)
バイナリサーチアルゴリズムを使用し、指定された short 値の配列から指定された値を検索します。

static



<T> int

binarySearch(T[] a,
             T key,
             Comparator<? super T> c)

バイナリサーチアルゴリズムを使用して、指定された配列から指定されたオブジェクトを検索します。

static boolean deepEquals(Object[] a1, Object[] a2)
2 つの指定された配列が相互に「深層で等価」な場合、true を返します。

static int deepHashCode(Object[] a)
指定された配列の「深層内容」に基づくハッシュコードを返します。

static String deepToString(Object[] a)
指定された配列の「深層内容」の文字列表現を返します。

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 int hashCode(boolean[] a)
指定された配列の内容に基づくハッシュコードを返します。

static int hashCode(byte[] a)
指定された配列の内容に基づくハッシュコードを返します。

static int hashCode(char[] a)
指定された配列の内容に基づくハッシュコードを返します。

static int hashCode(double[] a)
指定された配列の内容に基づくハッシュコードを返します。

static int hashCode(float[] a)
指定された配列の内容に基づくハッシュコードを返します。

static int hashCode(int[] a)
指定された配列の内容に基づくハッシュコードを返します。

static int hashCode(long[] a)
指定された配列の内容に基づくハッシュコードを返します。

static int hashCode(Object[] a)
指定された配列の内容に基づくハッシュコードを返します。

static int hashCode(short[] a)
指定された配列の内容に基づくハッシュコードを返します。

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, int fromIndex, int toIndex)
要素の「自然順序付け」に従って、指定されたオブジェクトの配列の指定された範囲を昇順でソートします。

static void sort(short[] a)
指定された short 値の配列を数値の昇順でソートします。

static void sort(short[] a, int fromIndex, int toIndex)
指定された short 値の配列を数値の昇順でソートします。

static



<T> void

sort(T[] a,
     Comparator<? super T> c)

指定されたコンパレータが示す順序に従って、指定されたオブジェクトの配列をソートします。

static



<T> void

sort(T[] a,
     int fromIndex,
     int toIndex,
     Comparator<? super T> c)

指定されたコンパレータの順番に従って、指定されたオブジェクトの配列の指定範囲を昇順でソートします。

static String toString(boolean[] a)
指定された配列の内容の文字列表現を返します。

static String toString(byte[] a)
指定された配列の内容の文字列表現を返します。

static String toString(char[] a)
指定された配列の内容の文字列表現を返します。

static String toString(double[] a)
指定された配列の内容の文字列表現を返します。

static String toString(float[] a)
指定された配列の内容の文字列表現を返します。

static String toString(int[] a)
指定された配列の内容の文字列表現を返します。

static String toString(long[] a)
指定された配列の内容の文字列表現を返します。

static String toString(Object[] a)
指定された配列の文字列表現を返します。

static String toString(short[] a)
指定された配列の内容の文字列表現を返します。

クラス 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 の二乗のパフォーマンスに低下させる多くのデータセットにおいて、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 の二乗のパフォーマンスに低下させる多くのデータセットにおいて、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 の二乗のパフォーマンスに低下させる多くのデータセットにおいて、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 の二乗のパフォーマンスに低下させる多くのデータセットにおいて、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 の二乗のパフォーマンスに低下させる多くのデータセットにおいて、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 の二乗のパフォーマンスに低下させる多くのデータセットにおいて、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 <T> void sort(T[] a,
                            Comparator<? super T> c)

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

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

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

sort

public static <T> void sort(T[] a,
                            int fromIndex,
                            int toIndex,
                            Comparator<? super T> 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 <T> int binarySearch(T[] a,
                                   T key,
                                   Comparator<? super T> 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 <T> List<T> asList(T... a)

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

このメソッドは、次の数種類の要素を含むように初期化する固定サイズのリストを作成するための便利な方法も提供します。


     List stooges = Arrays.asList("Larry", "Moe", "Curly");

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

hashCode

public static int hashCode(long[] a)

指定された配列の内容に基づくハッシュコードを返します。2 つの long 配列 a および b を Arrays.equals(a, b) のように表現できる場合、これを Arrays.hashCode(a) == Arrays.hashCode(b) とも表現できます。

このメソッドが返す値は、a の要素を同じ順序で表現する Long インスタンスのシーケンスを含む List に対し、hashCode メソッドを呼び出して取得する値と同じです。a が null の場合、このメソッドは 0 を返します。

パラメータ:: a - ハッシュ値を計算する配列
戻り値:: a の内容ベースのハッシュコード
導入されたバージョン:: 1.5

hashCode

public static int hashCode(int[] a)

指定された配列の内容に基づくハッシュコードを返します。2 つの null 以外の int 配列 a および b を Arrays.equals(a, b) のように表現できる場合、これを Arrays.hashCode(a) == Arrays.hashCode(b) とも表現できます。

このメソッドが返す値は、a の要素を同じ順序で表現する Integer インスタンスのシーケンスを含む List に対し、hashCode メソッドを呼び出して取得する値と同じです。a が null の場合、このメソッドは 0 を返します。

パラメータ:: a - ハッシュ値を計算する配列
戻り値:: a の内容ベースのハッシュコード
導入されたバージョン:: 1.5

hashCode

public static int hashCode(short[] a)

指定された配列の内容に基づくハッシュコードを返します。2 つの short 配列 a および b を Arrays.equals(a, b) のように表現できる場合、これを Arrays.hashCode(a) == Arrays.hashCode(b) とも表現できます。

このメソッドが返す値は、a の要素を同じ順序で表現する Short インスタンスのシーケンスを含む List に対し、hashCode メソッドを呼び出して取得する値と同じです。a が null の場合、このメソッドは 0 を返します。

パラメータ:: a - ハッシュ値を計算する配列
戻り値:: a の内容ベースのハッシュコード
導入されたバージョン:: 1.5

hashCode

public static int hashCode(char[] a)

指定された配列の内容に基づくハッシュコードを返します。2 つの char 配列 a および b を Arrays.equals(a, b) のように表現できる場合、これを Arrays.hashCode(a) == Arrays.hashCode(b) とも表現できます。

このメソッドが返す値は、a の要素を同じ順序で表現する Character インスタンスのシーケンスを含む List に対し、hashCode メソッドを呼び出して取得する値と同じです。a が null の場合、このメソッドは 0 を返します。

パラメータ:: a - ハッシュ値を計算する配列
戻り値:: a の内容ベースのハッシュコード
導入されたバージョン:: 1.5

hashCode

public static int hashCode(byte[] a)

指定された配列の内容に基づくハッシュコードを返します。2 つの byte 配列 a および b を Arrays.equals(a, b) のように表現できる場合、これを Arrays.hashCode(a) == Arrays.hashCode(b) とも表現できます。

このメソッドが返す値は、a の要素を同じ順序で表現する Byte インスタンスのシーケンスを含む List に対し、hashCode メソッドを呼び出して取得する値と同じです。a が null の場合、このメソッドは 0 を返します。

パラメータ:: a - ハッシュ値を計算する配列
戻り値:: a の内容ベースのハッシュコード
導入されたバージョン:: 1.5

hashCode

public static int hashCode(boolean[] a)

指定された配列の内容に基づくハッシュコードを返します。2 つの boolean 配列 a および b を Arrays.equals(a, b) のように表現できる場合、これを Arrays.hashCode(a) == Arrays.hashCode(b) とも表現できます。

このメソッドが返す値は、a の要素を同じ順序で表現する Boolean インスタンスのシーケンスを含む List に対し、hashCode メソッドを呼び出して取得する値と同じです。a が null の場合、このメソッドは 0 を返します。

パラメータ:: a - ハッシュ値を計算する配列
戻り値:: a の内容ベースのハッシュコード
導入されたバージョン:: 1.5

hashCode

public static int hashCode(float[] a)

指定された配列の内容に基づくハッシュコードを返します。2 つの float 配列 a および b を Arrays.equals(a, b) のように表現できる場合、これを Arrays.hashCode(a) == Arrays.hashCode(b) とも表現できます。

このメソッドが返す値は、a の要素を同じ順序で表現する Float インスタンスのシーケンスを含む List に対し、hashCode メソッドを呼び出して取得する値と同じです。a が null の場合、このメソッドは 0 を返します。

パラメータ:: a - ハッシュ値を計算する配列
戻り値:: a の内容ベースのハッシュコード
導入されたバージョン:: 1.5

hashCode

public static int hashCode(double[] a)

指定された配列の内容に基づくハッシュコードを返します。2 つの double 配列 a および b を Arrays.equals(a, b) のように表現できる場合、これを Arrays.hashCode(a) == Arrays.hashCode(b) とも表現できます。

このメソッドが返す値は、a の要素を同じ順序で表現する Double インスタンスのシーケンスを含む List に対し、hashCode メソッドを呼び出して取得する値と同じです。a が null の場合、このメソッドは 0 を返します。

パラメータ:: a - ハッシュ値を計算する配列
戻り値:: a の内容ベースのハッシュコード
導入されたバージョン:: 1.5

hashCode

public static int hashCode(Object[] a)

指定された配列の内容に基づくハッシュコードを返します。配列に要素以外の配列が含まれる場合、ハッシュコードは内容ではなく識別情報に基づいたものになります。これにより、自身を要素として含む配列に対して、このメソッドを 1 つまたは複数の配列レベルを介して直接または間接的に呼び出すことが可能になります。

2 つの配列 a および b を Arrays.equals(a, b) と表現できる場合、これを Arrays.hashCode(a) == Arrays.hashCode(b) とも表現できます。

このメソッドにより返される値は、a が null である場合を除き、Arrays.asList(a).hashCode() により返される値に等しくなります。a が null である場合は、0 が返されます。

パラメータ:: a - 内容ベースのハッシュコードを計算する配列
戻り値:: a の内容ベースのハッシュコード
導入されたバージョン:: 1.5
関連項目:: deepHashCode(Object[])

deepHashCode

public static int deepHashCode(Object[] a)

指定された配列の「深層内容」に基づくハッシュコードを返します。配列に要素以外の配列が含まれる場合、ハッシュコードは内容およびその他すべてに基づいたものになります。このため、自身を要素として含む配列に対して、このメソッドを 1 つまたは複数の配列レベルを介して直接または間接的に呼び出すことはできません。この種の呼び出し動作は、定義されていません。

2 つの配列 a および b を Arrays.deepEquals(a, b) と表現できる場合、これを Arrays.deepHashCode(a) == Arrays.deepHashCode(b) とも表現できます。

このメソッドにより返される値の計算は、a と同じ要素を同じ順序で含むリストに対する List.hashCode() により返される値の計算と類似しています。ただし、a の要素 e 自身が配列の場合、そのハッシュコードの計算は、e.hashCode() を呼び出すのではなく、Arrays.hashCode(e) の適切なオーバーロードを呼び出すか (e がプリミティブ型の配列である場合)、Arrays.deepHashCode(e) を再帰的に呼び出す (e が参照型の配列である場合) ことにより実行されます。a が null の場合、このメソッドは 0 を返します。

パラメータ:: a - 深層内容ベースのハッシュコードを計算する配列
戻り値:: a の深層内容ベースのハッシュコード
導入されたバージョン:: 1.5
関連項目:: hashCode(Object[])

deepEquals

public static boolean deepEquals(Object[] a1,
                                 Object[] a2)

2 つの指定された配列が相互に「深層で等価」な場合、true を返します。(Object[],Object[]) メソッドとは異なり、このメソッドは任意の深さで入れ子にされた配列での使用に適しています。

両方が null である場合、2 つの配列参照は深層で等価であると見なされます。また、同数の要素を含む配列を参照する場合、2 つの配列内の対応する要素ペアは深層で等価になります。

null の可能性がある 2 つの要素 e1 および e2 は、次の条件のどれかに適合する場合、深層で等価です。

e1 と e2 の両方がオブジェクト参照型の配列であり、Arrays.deepEquals(e1, e2) が true を返す
e1 と e2 が同じプリミティブ型の配列であり、Arrays.equals(e1, e2) の適切なオーバーロードが true を返す
e1 == e2
e1.equals(e2) が true を返す

この定義では、任意の深さの null 要素が許容される点に注意してください。

指定された配列のどちらかで、1 つまたは複数の配列レベルを介して直接または間接的に自身が要素として含まれる場合、このメソッドの動作は定義されていません。

パラメータ:: a1 - 同等であるかどうかを判定する 1 つ目の配列; a2 - 同等であるかどうかを判定する 2 つ目の配列
戻り値:: 2 つの配列が同等である場合は true
導入されたバージョン:: 1.5
関連項目:: equals(Object[],Object[])

toString

public static String toString(long[] a)

指定された配列の内容の文字列表現を返します。文字列表現は、角括弧 (「[]」) で囲まれた配列要素のリストで構成されます。隣接する要素は、文字「, 」(コンマおよび空白文字) で区切られます。要素は、String.valueOf(long) により文字列に変換されます。a が null の場合、「null」を返します。

パラメータ:: a - 文字列表現を返す配列
戻り値:: a の文字列表現
導入されたバージョン:: 1.5

toString

public static String toString(int[] a)

指定された配列の内容の文字列表現を返します。文字列表現は、角括弧 (「[]」) で囲まれた配列要素のリストで構成されます。隣接する要素は、文字「, 」(コンマおよび空白文字) で区切られます。要素は、String.valueOf(int) により文字列に変換されます。a が null の場合、「null」を返します。

パラメータ:: a - 文字列表現を返す配列
戻り値:: a の文字列表現
導入されたバージョン:: 1.5

toString

public static String toString(short[] a)

指定された配列の内容の文字列表現を返します。文字列表現は、角括弧 (「[]」) で囲まれた配列要素のリストで構成されます。隣接する要素は、文字「, 」(コンマおよび空白文字) で区切られます。要素は、String.valueOf(short) により文字列に変換されます。a が null の場合、「null」を返します。

パラメータ:: a - 文字列表現を返す配列
戻り値:: a の文字列表現
導入されたバージョン:: 1.5

toString

public static String toString(char[] a)

指定された配列の内容の文字列表現を返します。文字列表現は、角括弧 (「[]」) で囲まれた配列要素のリストで構成されます。隣接する要素は、文字「, 」(コンマおよび空白文字) で区切られます。要素は、String.valueOf(char) により文字列に変換されます。a が null の場合、「null」を返します。

パラメータ:: a - 文字列表現を返す配列
戻り値:: a の文字列表現
導入されたバージョン:: 1.5

toString

public static String toString(byte[] a)

指定された配列の内容の文字列表現を返します。文字列表現は、角括弧 (「[]」) で囲まれた配列要素のリストで構成されます。隣接する要素は、文字「, 」(コンマおよび空白文字) で区切られます。要素は、String.valueOf(byte) により文字列に変換されます。a が null の場合、「null」を返します。

パラメータ:: a - 文字列表現を返す配列
戻り値:: a の文字列表現
導入されたバージョン:: 1.5

toString

public static String toString(boolean[] a)

指定された配列の内容の文字列表現を返します。文字列表現は、角括弧 (「[]」) で囲まれた配列要素のリストで構成されます。隣接する要素は、文字「, 」(コンマおよび空白文字) で区切られます。要素は、String.valueOf(boolean) により文字列に変換されます。a が null の場合、「null」を返します。

パラメータ:: a - 文字列表現を返す配列
戻り値:: a の文字列表現
導入されたバージョン:: 1.5

toString

public static String toString(float[] a)

指定された配列の内容の文字列表現を返します。文字列表現は、角括弧 (「[]」) で囲まれた配列要素のリストで構成されます。隣接する要素は、文字「, 」(コンマおよび空白文字) で区切られます。要素は、String.valueOf(float) により文字列に変換されます。a が null の場合、「null」を返します。

パラメータ:: a - 文字列表現を返す配列
戻り値:: a の文字列表現
導入されたバージョン:: 1.5

toString

public static String toString(double[] a)

指定された配列の内容の文字列表現を返します。文字列表現は、角括弧 (「[]」) で囲まれた配列要素のリストで構成されます。隣接する要素は、文字「, 」(コンマおよび空白文字) で区切られます。要素は、String.valueOf(double) により文字列に変換されます。a が null の場合、「null」を返します。

パラメータ:: a - 文字列表現を返す配列
戻り値:: a の文字列表現
導入されたバージョン:: 1.5

toString

public static String toString(Object[] a)

指定された配列の文字列表現を返します。配列に要素以外の配列が含まれる場合、Object から拡張された Object.toString() メソッドにより配列が文字列に変換されます。Object には、内容ではなく識別情報が記述されています。

このメソッドにより返される値は、a が null である場合を除き、Arrays.asList(a).toString() により返される値と等しくなります。a が null である場合は、「null」が返されます。

パラメータ:: a - 文字列表現を返す配列
戻り値:: a の文字列表現
導入されたバージョン:: 1.5
関連項目:: deepToString(Object[])

deepToString

public static String deepToString(Object[] a)

指定された配列の「深層内容」の文字列表現を返します。配列に要素以外の配列が含まれる場合、文字列表現にはその内容等が含まれます。このメソッドは、多次元配列の文字列への変換用に設計されています。

文字列表現は、角括弧 (「[]」) で囲まれた配列要素のリストで構成されます。隣接する要素は、文字「, 」(コンマおよび空白文字) で区切られます。要素は、それ自体が配列でないかぎり String.valueOf(Object) により文字列に変換されます。

要素 e がプリミティブ型の配列である場合、Arrays.toString(e) の適切なオーバーロードを呼び出すことで文字列に変換されます。要素 e が参照型の配列である場合、このメソッドを再帰的に呼び出すことで文字列に変換されます。

無限の再帰を避けるため、指定された配列に自身が要素として含まれるか、1 つまたは複数の配列レベルを介した自身への間接参照が含まれる場合、自己参照は文字列「[...]」に変換されます。たとえば、自身への参照だけを含む配列は、「[[...]]」としてレンダリングされます。

指定された配列が null の場合、このメソッドは「null」を返します。

パラメータ:: a - 文字列表現を返す配列
戻り値:: a の文字列表現
導入されたバージョン:: 1.5
関連項目:: toString(Object[])

概要

パッケージ

クラス

使用

階層ツリー

非推奨 API

索引

ヘルプ

Java^TM 2 Platform
Standard Ed. 5.0

前のクラス 次のクラス

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

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

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

バグの報告と機能のリクエスト
さらに詳しい API リファレンスおよび開発者ドキュメントについては、Java 2 SDK SE 開発者用ドキュメントを参照してください。開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、およびコード実例が含まれています。

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

hashCode

hashCode

hashCode

hashCode

hashCode

hashCode

hashCode

hashCode

hashCode

deepHashCode

deepEquals

toString

toString

toString

toString

toString

toString

toString

toString

toString

deepToString

java.util
クラス Arrays