Arrays (Java Platform SE 6)

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

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

導入されたバージョン:: 1.2

メソッドの概要

static



<T> List<T>

asList(T... a)
指定された配列に連動する固定サイズのリストを返します。

static int binarySearch(byte[] a, byte key)
バイナリサーチアルゴリズムを使用して、指定された byte 値の配列から指定された値を検索します。

static int binarySearch(byte[] a, int fromIndex, int toIndex, byte key)
バイナリサーチアルゴリズムを使用して、指定された byte 値の配列から指定された値の範囲を検索します。

static int binarySearch(char[] a, char key)
バイナリサーチアルゴリズムを使用して、指定された char 値の配列から指定された値を検索します。

static int binarySearch(char[] a, int fromIndex, int toIndex, char key)
バイナリサーチアルゴリズムを使用して、指定された char 値の配列から指定された値の範囲を検索します。

static int binarySearch(double[] a, double key)
バイナリサーチアルゴリズムを使用して、指定された double 値の配列から指定された値を検索します。

static int binarySearch(double[] a, int fromIndex, int toIndex, double key)
バイナリサーチアルゴリズムを使用して、指定された double 値の配列から指定された値の範囲を検索します。

static int binarySearch(float[] a, float key)
バイナリサーチアルゴリズムを使用して、指定された float 値の配列から指定された値を検索します。

static int binarySearch(float[] a, int fromIndex, int toIndex, float key)
バイナリサーチアルゴリズムを使用して、指定された float 値の配列から指定された値の範囲を検索します。

static int binarySearch(int[] a, int key)
バイナリサーチアルゴリズムを使用して、指定された int 値の配列から指定された値を検索します。

static int binarySearch(int[] a, int fromIndex, int toIndex, int key)
バイナリサーチアルゴリズムを使用して、指定された int 値の配列から指定された値の範囲を検索します。

static int binarySearch(long[] a, int fromIndex, int toIndex, long key)
バイナリサーチアルゴリズムを使用して、指定された long 値の配列から指定された値の範囲を検索します。

static int binarySearch(long[] a, long key)
バイナリサーチアルゴリズムを使用して、指定された long 値の配列から指定された値を検索します。

static int binarySearch(Object[] a, int fromIndex, int toIndex, Object key)
バイナリサーチアルゴリズムを使用して、指定された配列の範囲から指定されたオブジェクトを検索します。

static int binarySearch(Object[] a, Object key)
バイナリサーチアルゴリズムを使用して、指定された配列から指定されたオブジェクトを検索します。

static int binarySearch(short[] a, int fromIndex, int toIndex, short key)
バイナリサーチアルゴリズムを使用して、指定された short 値の配列から指定された値の範囲を検索します。

static int binarySearch(short[] a, short key)
バイナリサーチアルゴリズムを使用し、指定された short 値の配列から指定された値を検索します。

static



<T> int

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

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

static



<T> int

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

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

static boolean[] copyOf(boolean[] original, int newLength)
指定された配列をコピーし、そのコピーが指定された長さになるように、必要に応じて切り詰めるか false でパディングします。

static byte[] copyOf(byte[] original, int newLength)
指定された配列をコピーし、そのコピーが指定された長さになるように、必要に応じて切り詰めるかゼロでパディングします。

static char[] copyOf(char[] original, int newLength)
指定された配列をコピーし、そのコピーが指定された長さになるように、必要に応じて切り詰めるか null 文字でパディングします。

static double[] copyOf(double[] original, int newLength)
指定された配列をコピーし、そのコピーが指定された長さになるように、必要に応じて切り詰めるかゼロでパディングします。

static float[] copyOf(float[] original, int newLength)
指定された配列をコピーし、そのコピーが指定された長さになるように、必要に応じて切り詰めるかゼロでパディングします。

static int[] copyOf(int[] original, int newLength)
指定された配列をコピーし、そのコピーが指定された長さになるように、必要に応じて切り詰めるかゼロでパディングします。

static long[] copyOf(long[] original, int newLength)
指定された配列をコピーし、そのコピーが指定された長さになるように、必要に応じて切り詰めるかゼロでパディングします。

static short[] copyOf(short[] original, int newLength)
指定された配列をコピーし、そのコピーが指定された長さになるように、必要に応じて切り詰めるかゼロでパディングします。

static



<T> T[]

copyOf(T[] original,
       int newLength)

指定された配列をコピーし、そのコピーが指定された長さになるように、必要に応じて切り詰めるか null でパディングします。

static



<T,U> T[]

copyOf(U[] original,
       int newLength,
       Class<? extends T[]> newType)

指定された配列をコピーし、そのコピーが指定された長さになるように、必要に応じて切り詰めるか null でパディングします。

static boolean[] copyOfRange(boolean[] original, int from, int to)
指定された配列の指定された範囲を新しい配列にコピーします。

static byte[] copyOfRange(byte[] original, int from, int to)
指定された配列の指定された範囲を新しい配列にコピーします。

static char[] copyOfRange(char[] original, int from, int to)
指定された配列の指定された範囲を新しい配列にコピーします。

static double[] copyOfRange(double[] original, int from, int to)
指定された配列の指定された範囲を新しい配列にコピーします。

static float[] copyOfRange(float[] original, int from, int to)
指定された配列の指定された範囲を新しい配列にコピーします。

static int[] copyOfRange(int[] original, int from, int to)
指定された配列の指定された範囲を新しい配列にコピーします。

static long[] copyOfRange(long[] original, int from, int to)
指定された配列の指定された範囲を新しい配列にコピーします。

static short[] copyOfRange(short[] original, int from, int to)
指定された配列の指定された範囲を新しい配列にコピーします。

static



<T> T[]

copyOfRange(T[] original,
            int from,
            int to)

指定された配列の指定された範囲を新しい配列にコピーします。

static



<T,U> T[]

copyOfRange(U[] original,
            int from,
            int to,
            Class<? extends T[]> newType)

指定された配列の指定された範囲を新しい配列にコピーします。

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 - 配列に「相互に比較可能」でない要素 (たとえば、文字列と整数) がある場合

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 - 配列に「相互に比較可能」でない要素 (たとえば、文字列と整数) がある場合

sort

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

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

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

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

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 の場合

binarySearch

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

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

パラメータ:: a - 検索される配列; key - 検索される値
戻り値:: 配列に検索キーがある場合は検索キーのインデックス。検索キーがリストにない場合は (-(挿入ポイント) - 1)挿入ポイントとは、配列でキーが挿入されるポイントである。つまり、キーより大きな最初の要素のインデックスか、配列のすべての要素が指定されたキーより小さい場合は a.length。これにより、キーが見つかった場合にだけ戻り値が >= 0 になることが保証される

binarySearch

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

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

パラメータ:: a - 検索される配列; fromIndex - 検索される最初の要素 (範囲内) のインデックス; toIndex - 検索される最後の要素 (範囲外) のインデックス; key - 検索される値
戻り値:: 指定された範囲内の配列に検索キーがある場合は検索キーのインデックス。検索キーがリストにない場合は (-(挿入ポイント) - 1)。挿入ポイントとは、配列でキーが挿入されるポイントである。つまり、キーより大きな範囲内の最初の要素のインデックスか、範囲内のすべての要素が指定されたキーより小さい場合は toIndex。これにより、キーが見つかった場合にだけ戻り値が >= 0 になることが保証される
例外:: IllegalArgumentException - fromIndex > toIndex の場合; ArrayIndexOutOfBoundsException - fromIndex < 0 または toIndex > a.length の場合
導入されたバージョン:: 1.6

binarySearch

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

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

パラメータ:: a - 検索される配列; key - 検索される値
戻り値:: 配列に検索キーがある場合は検索キーのインデックス。検索キーがリストにない場合は (-(挿入ポイント) - 1)。挿入ポイントとは、配列でキーが挿入されるポイントである。つまり、キーより大きな最初の要素のインデックスか、配列のすべての要素が指定されたキーより小さい場合は a.length。これにより、キーが見つかった場合にだけ戻り値が >= 0 になることが保証される

binarySearch

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

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

パラメータ:: a - 検索される配列; fromIndex - 検索される最初の要素 (範囲内) のインデックス; toIndex - 検索される最後の要素 (範囲外) のインデックス; key - 検索される値
戻り値:: 指定された範囲内の配列に検索キーがある場合は検索キーのインデックス。検索キーがリストにない場合は (-(挿入ポイント) - 1)。挿入ポイントとは、配列でキーが挿入されるポイントである。つまり、キーより大きな範囲内の最初の要素のインデックスか、範囲内のすべての要素が指定されたキーより小さい場合は toIndex。これにより、キーが見つかった場合にだけ戻り値が >= 0 になることが保証される
例外:: IllegalArgumentException - fromIndex > toIndex の場合; ArrayIndexOutOfBoundsException - fromIndex < 0 または toIndex > a.length の場合
導入されたバージョン:: 1.6

binarySearch

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

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

パラメータ:: a - 検索される配列; key - 検索される値
戻り値:: 配列に検索キーがある場合は検索キーのインデックス。検索キーがリストにない場合は (-(挿入ポイント) - 1)。挿入ポイントとは、配列でキーが挿入されるポイントである。つまり、キーより大きな最初の要素のインデックスか、配列のすべての要素が指定されたキーより小さい場合は a.length。これにより、キーが見つかった場合にだけ戻り値が >= 0 になることが保証される

binarySearch

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

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

パラメータ:: a - 検索される配列; fromIndex - 検索される最初の要素 (範囲内) のインデックス; toIndex - 検索される最後の要素 (範囲外) のインデックス; key - 検索される値
戻り値:: 指定された範囲内の配列に検索キーがある場合は検索キーのインデックス。検索キーがリストにない場合は (-(挿入ポイント) - 1)。挿入ポイントとは、配列でキーが挿入されるポイントである。つまり、キーより大きな範囲内の最初の要素のインデックスか、範囲内のすべての要素が指定されたキーより小さい場合は toIndex。これにより、キーが見つかった場合にだけ戻り値が >= 0 になることが保証される
例外:: IllegalArgumentException - fromIndex > toIndex の場合; ArrayIndexOutOfBoundsException - fromIndex < 0 または toIndex > a.length の場合
導入されたバージョン:: 1.6

binarySearch

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

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

パラメータ:: a - 検索される配列; key - 検索される値
戻り値:: 配列に検索キーがある場合は検索キーのインデックス。検索キーがリストにない場合は (-(挿入ポイント) - 1)。挿入ポイントとは、配列でキーが挿入されるポイントである。つまり、キーより大きな最初の要素のインデックスか、配列のすべての要素が指定されたキーより小さい場合は a.length。これにより、キーが見つかった場合にだけ戻り値が >= 0 になることが保証される

binarySearch

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

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

パラメータ:: a - 検索される配列; fromIndex - 検索される最初の要素 (範囲内) のインデックス; toIndex - 検索される最後の要素 (範囲外) のインデックス; key - 検索される値
戻り値:: 指定された範囲内の配列に検索キーがある場合は検索キーのインデックス。検索キーがリストにない場合は (-(挿入ポイント) - 1)。挿入ポイントとは、配列でキーが挿入されるポイントである。つまり、キーより大きな範囲内の最初の要素のインデックスか、範囲内のすべての要素が指定されたキーより小さい場合は toIndex。これにより、キーが見つかった場合にだけ戻り値が >= 0 になることが保証される
例外:: IllegalArgumentException - fromIndex > toIndex の場合; ArrayIndexOutOfBoundsException - fromIndex < 0 または toIndex > a.length の場合
導入されたバージョン:: 1.6

binarySearch

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

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

パラメータ:: a - 検索される配列; key - 検索される値
戻り値:: 配列に検索キーがある場合は検索キーのインデックス。検索キーがリストにない場合は (-(挿入ポイント) - 1)。挿入ポイントとは、配列でキーが挿入されるポイントである。つまり、キーより大きな最初の要素のインデックスか、配列のすべての要素が指定されたキーより小さい場合は a.length。これにより、キーが見つかった場合にだけ戻り値が >= 0 になることが保証される

binarySearch

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

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

パラメータ:: a - 検索される配列; fromIndex - 検索される最初の要素 (範囲内) のインデックス; toIndex - 検索される最後の要素 (範囲外) のインデックス; key - 検索される値
戻り値:: 指定された範囲内の配列に検索キーがある場合は検索キーのインデックス。検索キーがリストにない場合は (-(挿入ポイント) - 1)。挿入ポイントとは、配列でキーが挿入されるポイントである。つまり、キーより大きな範囲内の最初の要素のインデックスか、範囲内のすべての要素が指定されたキーより小さい場合は toIndex。これにより、キーが見つかった場合にだけ戻り値が >= 0 になることが保証される
例外:: IllegalArgumentException - fromIndex > toIndex の場合; ArrayIndexOutOfBoundsException - fromIndex < 0 または toIndex > a.length の場合
導入されたバージョン:: 1.6

binarySearch

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

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

パラメータ:: a - 検索される配列; key - 検索される値
戻り値:: 配列に検索キーがある場合は検索キーのインデックス。検索キーがリストにない場合は (-(挿入ポイント) - 1)。挿入ポイントとは、配列でキーが挿入されるポイントである。つまり、キーより大きな最初の要素のインデックスか、配列のすべての要素が指定されたキーより小さい場合は a.length。これにより、キーが見つかった場合にだけ戻り値が >= 0 になることが保証される

binarySearch

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

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

パラメータ:: a - 検索される配列; fromIndex - 検索される最初の要素 (範囲内) のインデックス; toIndex - 検索される最後の要素 (範囲外) のインデックス; key - 検索される値
戻り値:: 指定された範囲内の配列に検索キーがある場合は検索キーのインデックス。検索キーがリストにない場合は (-(挿入ポイント) - 1)。挿入ポイントとは、配列でキーが挿入されるポイントである。つまり、キーより大きな範囲内の最初の要素のインデックスか、範囲内のすべての要素が指定されたキーより小さい場合は toIndex。これにより、キーが見つかった場合にだけ戻り値が >= 0 になることが保証される
例外:: IllegalArgumentException - fromIndex > toIndex の場合; ArrayIndexOutOfBoundsException - fromIndex < 0 または toIndex > a.length の場合
導入されたバージョン:: 1.6

binarySearch

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

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

パラメータ:: a - 検索される配列; key - 検索される値
戻り値:: 配列に検索キーがある場合は検索キーのインデックス。検索キーがリストにない場合は (-(挿入ポイント) - 1)。挿入ポイントとは、配列でキーが挿入されるポイントである。つまり、キーより大きな最初の要素のインデックスか、配列のすべての要素が指定されたキーより小さい場合は a.length。これにより、キーが見つかった場合にだけ戻り値が >= 0 になることが保証される

binarySearch

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

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

パラメータ:: a - 検索される配列; fromIndex - 検索される最初の要素 (範囲内) のインデックス; toIndex - 検索される最後の要素 (範囲外) のインデックス; key - 検索される値
戻り値:: 指定された範囲内の配列に検索キーがある場合は検索キーのインデックス。検索キーがリストにない場合は (-(挿入ポイント) - 1)。挿入ポイントとは、配列でキーが挿入されるポイントである。つまり、キーより大きな範囲内の最初の要素のインデックスか、範囲内のすべての要素が指定されたキーより小さい場合は toIndex。これにより、キーが見つかった場合にだけ戻り値が >= 0 になることが保証される
例外:: IllegalArgumentException - fromIndex > toIndex の場合; ArrayIndexOutOfBoundsException - fromIndex < 0 または toIndex > a.length の場合
導入されたバージョン:: 1.6

binarySearch

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

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

パラメータ:: a - 検索される配列; key - 検索される値
戻り値:: 配列に検索キーがある場合は検索キーのインデックス。検索キーがリストにない場合は (-(挿入ポイント) - 1)。挿入ポイントとは、配列でキーが挿入されるポイントである。つまり、キーより大きな最初の要素のインデックスか、配列のすべての要素が指定されたキーより小さい場合は a.length。これにより、キーが見つかった場合にだけ戻り値が >= 0 になることが保証される
例外:: ClassCastException - 検索キーが配列の要素と同等でない場合

binarySearch

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

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

パラメータ:: a - 検索される配列; fromIndex - 検索される最初の要素 (範囲内) のインデックス; toIndex - 検索される最後の要素 (範囲外) のインデックス; key - 検索される値
戻り値:: 指定された範囲内の配列に検索キーがある場合は検索キーのインデックス。検索キーがリストにない場合は (-(挿入ポイント) - 1)。挿入ポイントとは、配列でキーが挿入されるポイントである。つまり、キーより大きな範囲内の最初の要素のインデックスか、範囲内のすべての要素が指定されたキーより小さい場合は toIndex。これにより、キーが見つかった場合にだけ戻り値が >= 0 になることが保証される
例外:: ClassCastException - 検索キーが指定された範囲内の配列の要素と同等でない場合; IllegalArgumentException - fromIndex > toIndex の場合; ArrayIndexOutOfBoundsException - fromIndex < 0 または toIndex > a.length の場合
導入されたバージョン:: 1.6

binarySearch

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

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

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

binarySearch

public static <T> int binarySearch(T[] a,
                                   int fromIndex,
                                   int toIndex,
                                   T key,
                                   Comparator<? super T> c)

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

パラメータ:: a - 検索される配列; fromIndex - 検索される最初の要素 (範囲内) のインデックス; toIndex - 検索される最後の要素 (範囲外) のインデックス; key - 検索される値; c - 配列が順序付けされるコンパレータ。null 値は、要素の自然順序付けを使用することを示す
戻り値:: 指定された範囲内の配列に検索キーがある場合は検索キーのインデックス。検索キーがリストにない場合は (-(挿入ポイント) - 1)。挿入ポイントとは、配列でキーが挿入されるポイントである。つまり、キーより大きな範囲内の最初の要素のインデックスか、範囲内のすべての要素が指定されたキーより小さい場合は toIndex。これにより、キーが見つかった場合にだけ戻り値が >= 0 になることが保証される
例外:: ClassCastException - 指定されたコンパレータで「相互に比較可能」でない要素が範囲に含まれている場合、あるいは検索キーがこのコンパレータで範囲内の要素と相互に比較できない場合; IllegalArgumentException - fromIndex > toIndex の場合; ArrayIndexOutOfBoundsException - fromIndex < 0 または toIndex > a.length の場合
導入されたバージョン:: 1.6

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 - 配列のすべての要素に格納する値
例外:: ArrayStoreException - 指定された値が、指定された配列に格納できる実行時の型ではない場合

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 の場合; ArrayStoreException - 指定された値が、指定された配列に格納できる実行時の型ではない場合

copyOf

public static <T> T[] copyOf(T[] original,
                             int newLength)

指定された配列をコピーし、そのコピーが指定された長さになるように、必要に応じて切り詰めるか null でパディングします。元の配列とコピーの両方ですべてのインデックスが有効な場合は、2 つの配列に同じ値が含まれます。コピーでは有効でも、元の配列では有効でないインデックスがある場合、コピーには null が含まれます。そのようなインデックスは、指定された長さが元の配列の長さより大きい場合にだけ存在します。結果として得られる配列のクラスは、元の配列とまったく同じものです。

パラメータ:: original - コピーされる配列; newLength - 返されるコピーの長さ
戻り値:: 指定された長さにするために切り詰められた、または null でパディングされた元の配列のコピー
例外:: NegativeArraySizeException - newLength が負の値の場合; NullPointerException - original が null の場合
導入されたバージョン:: 1.6

copyOf

public static <T,U> T[] copyOf(U[] original,
                               int newLength,
                               Class<? extends T[]> newType)

パラメータ:: original - コピーされる配列; newLength - 返されるコピーの長さ; newType - 返されるコピーのクラス
戻り値:: 指定された長さにするために切り詰められた、または null でパディングされた元の配列のコピー
例外:: NegativeArraySizeException - newLength が負の値の場合; NullPointerException - original が null の場合; ArrayStoreException - original からコピーされる要素が、newType クラスの配列に格納できる実行時の型ではない場合
導入されたバージョン:: 1.6

copyOf

public static byte[] copyOf(byte[] original,
                            int newLength)

指定された配列をコピーし、そのコピーが指定された長さになるように、必要に応じて切り詰めるかゼロでパディングします。元の配列とコピーの両方ですべてのインデックスが有効な場合は、2 つの配列に同じ値が含まれます。コピーでは有効でも、元の配列では有効でないインデックスがある場合、コピーには (byte)0 が含まれます。そのようなインデックスは、指定された長さが元の配列の長さより大きい場合にだけ存在します。

パラメータ:: original - コピーされる配列; newLength - 返されるコピーの長さ
戻り値:: 指定された長さにするために切り詰められた、またはゼロでパディングされた元の配列のコピー
例外:: NegativeArraySizeException - newLength が負の値の場合; NullPointerException - original が null の場合
導入されたバージョン:: 1.6

copyOf

public static short[] copyOf(short[] original,
                             int newLength)

指定された配列をコピーし、そのコピーが指定された長さになるように、必要に応じて切り詰めるかゼロでパディングします。元の配列とコピーの両方ですべてのインデックスが有効な場合は、2 つの配列に同じ値が含まれます。コピーでは有効でも、元の配列では有効でないインデックスがある場合、コピーには (short)0 が含まれます。そのようなインデックスは、指定された長さが元の配列の長さより大きい場合にだけ存在します。

パラメータ:: original - コピーされる配列; newLength - 返されるコピーの長さ
戻り値:: 指定された長さにするために切り詰められた、またはゼロでパディングされた元の配列のコピー
例外:: NegativeArraySizeException - newLength が負の値の場合; NullPointerException - original が null の場合
導入されたバージョン:: 1.6

copyOf

public static int[] copyOf(int[] original,
                           int newLength)

指定された配列をコピーし、そのコピーが指定された長さになるように、必要に応じて切り詰めるかゼロでパディングします。元の配列とコピーの両方ですべてのインデックスが有効な場合は、2 つの配列に同じ値が含まれます。コピーでは有効でも、元の配列では有効でないインデックスがある場合、コピーには 0 が含まれます。そのようなインデックスは、指定された長さが元の配列の長さより大きい場合にだけ存在します。

パラメータ:: original - コピーされる配列; newLength - 返されるコピーの長さ
戻り値:: 指定された長さにするために切り詰められた、またはゼロでパディングされた元の配列のコピー
例外:: NegativeArraySizeException - newLength が負の値の場合; NullPointerException - original が null の場合
導入されたバージョン:: 1.6

copyOf

public static long[] copyOf(long[] original,
                            int newLength)

指定された配列をコピーし、そのコピーが指定された長さになるように、必要に応じて切り詰めるかゼロでパディングします。元の配列とコピーの両方ですべてのインデックスが有効な場合は、2 つの配列に同じ値が含まれます。コピーでは有効でも、元の配列では有効でないインデックスがある場合、コピーには 0L が含まれます。そのようなインデックスは、指定された長さが元の配列の長さより大きい場合にだけ存在します。

パラメータ:: original - コピーされる配列; newLength - 返されるコピーの長さ
戻り値:: 指定された長さにするために切り詰められた、またはゼロでパディングされた元の配列のコピー
例外:: NegativeArraySizeException - newLength が負の値の場合; NullPointerException - original が null の場合
導入されたバージョン:: 1.6

copyOf

public static char[] copyOf(char[] original,
                            int newLength)

指定された配列をコピーし、そのコピーが指定された長さになるように、必要に応じて切り詰めるか null 文字でパディングします。元の配列とコピーの両方ですべてのインデックスが有効な場合は、2 つの配列に同じ値が含まれます。コピーでは有効でも、元の配列では有効でないインデックスがある場合、コピーには '\\u000' が含まれます。そのようなインデックスは、指定された長さが元の配列の長さより大きい場合にだけ存在します。

パラメータ:: original - コピーされる配列; newLength - 返されるコピーの長さ
戻り値:: 指定された長さにするために切り詰められた、または null 文字でパディングされた元の配列のコピー
例外:: NegativeArraySizeException - newLength が負の値の場合; NullPointerException - original が null の場合
導入されたバージョン:: 1.6

copyOf

public static float[] copyOf(float[] original,
                             int newLength)

指定された配列をコピーし、そのコピーが指定された長さになるように、必要に応じて切り詰めるかゼロでパディングします。元の配列とコピーの両方ですべてのインデックスが有効な場合は、2 つの配列に同じ値が含まれます。コピーでは有効でも、元の配列では有効でないインデックスがある場合、コピーには 0f が含まれます。そのようなインデックスは、指定された長さが元の配列の長さより大きい場合にだけ存在します。

パラメータ:: original - コピーされる配列; newLength - 返されるコピーの長さ
戻り値:: 指定された長さにするために切り詰められた、またはゼロでパディングされた元の配列のコピー
例外:: NegativeArraySizeException - newLength が負の値の場合; NullPointerException - original が null の場合
導入されたバージョン:: 1.6

copyOf

public static double[] copyOf(double[] original,
                              int newLength)

指定された配列をコピーし、そのコピーが指定された長さになるように、必要に応じて切り詰めるかゼロでパディングします。元の配列とコピーの両方ですべてのインデックスが有効な場合は、2 つの配列に同じ値が含まれます。コピーでは有効でも、元の配列では有効でないインデックスがある場合、コピーには 0d が含まれます。そのようなインデックスは、指定された長さが元の配列の長さより大きい場合にだけ存在します。

パラメータ:: original - コピーされる配列; newLength - 返されるコピーの長さ
戻り値:: 指定された長さにするために切り詰められた、またはゼロでパディングされた元の配列のコピー
例外:: NegativeArraySizeException - newLength が負の値の場合; NullPointerException - original が null の場合
導入されたバージョン:: 1.6

copyOf

public static boolean[] copyOf(boolean[] original,
                               int newLength)

指定された配列をコピーし、そのコピーが指定された長さになるように、必要に応じて切り詰めるか false でパディングします。元の配列とコピーの両方ですべてのインデックスが有効な場合は、2 つの配列に同じ値が含まれます。コピーでは有効でも、元の配列では有効でないインデックスがある場合、コピーには false が含まれます。そのようなインデックスは、指定された長さが元の配列の長さより大きい場合にだけ存在します。

パラメータ:: original - コピーされる配列; newLength - 返されるコピーの長さ
戻り値:: 指定された長さにするために切り詰められた、または false 要素でパディングされた元の配列のコピー
例外:: NegativeArraySizeException - newLength が負の値の場合; NullPointerException - original が null の場合
導入されたバージョン:: 1.6

copyOfRange

public static <T> T[] copyOfRange(T[] original,
                                  int from,
                                  int to)

指定された配列の指定された範囲を新しい配列にコピーします。範囲の最初のインデックス (from) は、ゼロから original.length の範囲の値でなければなりません。original[from] の値は、from == original.length または from == to でないかぎり、コピーの最初の要素に配置されます。元の配列のその後の要素の値は、コピーのその後の要素に配置されます。範囲の最後のインデックス (to) は、from 以上でなければならず、original.length より大きくてもかまいません。その場合、インデックスが original.length - from 以上のコピーのすべての要素に null が配置されます。返される配列の長さは to - from になります。

結果として得られる配列のクラスは、元の配列とまったく同じものです。

パラメータ:: original - 範囲のコピー先となる配列; from - コピーされる範囲の最初のインデックス (範囲内); to - コピーされる範囲の最後のインデックス (範囲内) (このインデックスは配列の外側に存在することもある)
戻り値:: 必要な長さにするために切り詰められた、または null でパディングされた、元の配列の指定された範囲を含む新しい配列
例外:: ArrayIndexOutOfBoundsException - from < 0 または from > original.length() の場合; IllegalArgumentException - from > to の場合; NullPointerException - original が null の場合
導入されたバージョン:: 1.6

copyOfRange

public static <T,U> T[] copyOfRange(U[] original,
                                    int from,
                                    int to,
                                    Class<? extends T[]> newType)

パラメータ:: original - 範囲のコピー先となる配列; from - コピーされる範囲の最初のインデックス (範囲内); to - コピーされる範囲の最後のインデックス (範囲内) (このインデックスは配列の外側に存在することもある); newType - 返されるコピーのクラス
戻り値:: 必要な長さにするために切り詰められた、または null でパディングされた、元の配列の指定された範囲を含む新しい配列
例外:: ArrayIndexOutOfBoundsException - from < 0 または from > original.length() の場合; IllegalArgumentException - from > to の場合; NullPointerException - original が null の場合; ArrayStoreException - original からコピーされる要素が、newType クラスの配列に格納できる実行時の型ではない場合
導入されたバージョン:: 1.6

copyOfRange

public static byte[] copyOfRange(byte[] original,
                                 int from,
                                 int to)

指定された配列の指定された範囲を新しい配列にコピーします。範囲の最初のインデックス (from) は、ゼロから original.length の範囲の値でなければなりません。original[from] の値は、from == original.length または from == to でないかぎり、コピーの最初の要素に配置されます。元の配列のその後の要素の値は、コピーのその後の要素に配置されます。範囲の最後のインデックス (to) は、from 以上でなければならず、original.length より大きくてもかまいません。その場合、インデックスが original.length - from 以上のコピーのすべての要素に (byte)0 が配置されます。返される配列の長さは to - from になります。

パラメータ:: original - 範囲のコピー先となる配列; from - コピーされる範囲の最初のインデックス (範囲内); to - コピーされる範囲の最後のインデックス (範囲内) (このインデックスは配列の外側に存在することもある)
戻り値:: 必要な長さにするために切り詰められた、またはゼロでパディングされた、元の配列の指定された範囲を含む新しい配列
例外:: ArrayIndexOutOfBoundsException - from < 0 または from > original.length() の場合; IllegalArgumentException - from > to の場合; NullPointerException - original が null の場合
導入されたバージョン:: 1.6

copyOfRange

public static short[] copyOfRange(short[] original,
                                  int from,
                                  int to)

指定された配列の指定された範囲を新しい配列にコピーします。範囲の最初のインデックス (from) は、ゼロから original.length の範囲の値でなければなりません。original[from] の値は、from == original.length または from == to でないかぎり、コピーの最初の要素に配置されます。元の配列のその後の要素の値は、コピーのその後の要素に配置されます。範囲の最後のインデックス (to) は、from 以上でなければならず、original.length より大きくてもかまいません。その場合、インデックスが original.length - from 以上のコピーのすべての要素に (short)0 が配置されます。返される配列の長さは to - from になります。

パラメータ:: original - 範囲のコピー先となる配列; from - コピーされる範囲の最初のインデックス (範囲内); to - コピーされる範囲の最後のインデックス (範囲内) (このインデックスは配列の外側に存在することもある)
戻り値:: 必要な長さにするために切り詰められた、またはゼロでパディングされた、元の配列の指定された範囲を含む新しい配列
例外:: ArrayIndexOutOfBoundsException - from < 0 または from > original.length() の場合; IllegalArgumentException - from > to の場合; NullPointerException - original が null の場合
導入されたバージョン:: 1.6

copyOfRange

public static int[] copyOfRange(int[] original,
                                int from,
                                int to)

指定された配列の指定された範囲を新しい配列にコピーします。範囲の最初のインデックス (from) は、ゼロから original.length の範囲の値でなければなりません。original[from] の値は、from == original.length または from == to でないかぎり、コピーの最初の要素に配置されます。元の配列のその後の要素の値は、コピーのその後の要素に配置されます。範囲の最後のインデックス (to) は、from 以上でなければならず、original.length より大きくてもかまいません。その場合、インデックスが original.length - from 以上のコピーのすべての要素に 0 が配置されます。返される配列の長さは to - from になります。

パラメータ:: original - 範囲のコピー先となる配列; from - コピーされる範囲の最初のインデックス (範囲内); to - コピーされる範囲の最後のインデックス (範囲内) (このインデックスは配列の外側に存在することもある)
戻り値:: 必要な長さにするために切り詰められた、またはゼロでパディングされた、元の配列の指定された範囲を含む新しい配列
例外:: ArrayIndexOutOfBoundsException - from < 0 または from > original.length() の場合; IllegalArgumentException - from > to の場合; NullPointerException - original が null の場合
導入されたバージョン:: 1.6

copyOfRange

public static long[] copyOfRange(long[] original,
                                 int from,
                                 int to)

指定された配列の指定された範囲を新しい配列にコピーします。範囲の最初のインデックス (from) は、ゼロから original.length の範囲の値でなければなりません。original[from] の値は、from == original.length または from == to でないかぎり、コピーの最初の要素に配置されます。元の配列のその後の要素の値は、コピーのその後の要素に配置されます。範囲の最後のインデックス (to) は、from 以上でなければならず、original.length より大きくてもかまいません。その場合、インデックスが original.length - from 以上のコピーのすべての要素に 0L が配置されます。返される配列の長さは to - from になります。

パラメータ:: original - 範囲のコピー先となる配列; from - コピーされる範囲の最初のインデックス (範囲内); to - コピーされる範囲の最後のインデックス (範囲内) (このインデックスは配列の外側に存在することもある)
戻り値:: 必要な長さにするために切り詰められた、またはゼロでパディングされた、元の配列の指定された範囲を含む新しい配列
例外:: ArrayIndexOutOfBoundsException - from < 0 または from > original.length() の場合; IllegalArgumentException - from > to の場合; NullPointerException - original が null の場合
導入されたバージョン:: 1.6

copyOfRange

public static char[] copyOfRange(char[] original,
                                 int from,
                                 int to)

指定された配列の指定された範囲を新しい配列にコピーします。範囲の最初のインデックス (from) は、ゼロから original.length の範囲の値でなければなりません。original[from] の値は、from == original.length または from == to でないかぎり、コピーの最初の要素に配置されます。元の配列のその後の要素の値は、コピーのその後の要素に配置されます。範囲の最後のインデックス (to) は、from 以上でなければならず、original.length より大きくてもかまいません。その場合、インデックスが original.length - from 以上のコピーのすべての要素に '\\u000' が配置されます。返される配列の長さは to - from になります。

パラメータ:: original - 範囲のコピー先となる配列; from - コピーされる範囲の最初のインデックス (範囲内); to - コピーされる範囲の最後のインデックス (範囲内) (このインデックスは配列の外側に存在することもある)
戻り値:: 必要な長さにするために切り詰められた、または null 文字でパディングされた、元の配列の指定された範囲を含む新しい配列
例外:: ArrayIndexOutOfBoundsException - from < 0 または from > original.length() の場合; IllegalArgumentException - from > to の場合; NullPointerException - original が null の場合
導入されたバージョン:: 1.6

copyOfRange

public static float[] copyOfRange(float[] original,
                                  int from,
                                  int to)

指定された配列の指定された範囲を新しい配列にコピーします。範囲の最初のインデックス (from) は、ゼロから original.length の範囲の値でなければなりません。original[from] の値は、from == original.length または from == to でないかぎり、コピーの最初の要素に配置されます。元の配列のその後の要素の値は、コピーのその後の要素に配置されます。範囲の最後のインデックス (to) は、from 以上でなければならず、original.length より大きくてもかまいません。その場合、インデックスが original.length - from 以上のコピーのすべての要素に 0f が配置されます。返される配列の長さは to - from になります。

パラメータ:: original - 範囲のコピー先となる配列; from - コピーされる範囲の最初のインデックス (範囲内); to - コピーされる範囲の最後のインデックス (範囲内) (このインデックスは配列の外側に存在することもある)
戻り値:: 必要な長さにするために切り詰められた、またはゼロでパディングされた、元の配列の指定された範囲を含む新しい配列
例外:: ArrayIndexOutOfBoundsException - from < 0 または from > original.length() の場合; IllegalArgumentException - from > to の場合; NullPointerException - original が null の場合
導入されたバージョン:: 1.6

copyOfRange

public static double[] copyOfRange(double[] original,
                                   int from,
                                   int to)

指定された配列の指定された範囲を新しい配列にコピーします。範囲の最初のインデックス (from) は、ゼロから original.length の範囲の値でなければなりません。original[from] の値は、from == original.length または from == to でないかぎり、コピーの最初の要素に配置されます。元の配列のその後の要素の値は、コピーのその後の要素に配置されます。範囲の最後のインデックス (to) は、from 以上でなければならず、original.length より大きくてもかまいません。その場合、インデックスが original.length - from 以上のコピーのすべての要素に 0d が配置されます。返される配列の長さは to - from になります。

パラメータ:: original - 範囲のコピー先となる配列; from - コピーされる範囲の最初のインデックス (範囲内); to - コピーされる範囲の最後のインデックス (範囲内) (このインデックスは配列の外側に存在することもある)
戻り値:: 必要な長さにするために切り詰められた、またはゼロでパディングされた、元の配列の指定された範囲を含む新しい配列
例外:: ArrayIndexOutOfBoundsException - from < 0 または from > original.length() の場合; IllegalArgumentException - from > to の場合; NullPointerException - original が null の場合
導入されたバージョン:: 1.6

copyOfRange

public static boolean[] copyOfRange(boolean[] original,
                                    int from,
                                    int to)

指定された配列の指定された範囲を新しい配列にコピーします。範囲の最初のインデックス (from) は、ゼロから original.length の範囲の値でなければなりません。original[from] の値は、from == original.length または from == to でないかぎり、コピーの最初の要素に配置されます。元の配列のその後の要素の値は、コピーのその後の要素に配置されます。範囲の最後のインデックス (to) は、from 以上でなければならず、original.length より大きくてもかまいません。その場合、インデックスが original.length - from 以上のコピーのすべての要素に false が配置されます。返される配列の長さは to - from になります。

パラメータ:: original - 範囲のコピー先となる配列; from - コピーされる範囲の最初のインデックス (範囲内); to - コピーされる範囲の最後のインデックス (範囲内) (このインデックスは配列の外側に存在することもある)
戻り値:: 必要な長さにするために切り詰められた、または false 要素でパディングされた、元の配列の指定された範囲を含む新しい配列
例外:: ArrayIndexOutOfBoundsException - from < 0 または from > original.length() の場合; IllegalArgumentException - from > to の場合; NullPointerException - original が null の場合
導入されたバージョン:: 1.6

asList

public static <T> List<T> asList(T... a)

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

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

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

パラメータ:: a - リストの基となる配列
戻り値:: 指定された配列のリスト表示

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 を返します。equals(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 Platform
Standard Ed. 6

前のクラス 次のクラス

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

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

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

バグの報告と機能のリクエスト
さらに詳しい API リファレンスおよび開発者ドキュメントについては、Java 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

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

copyOf

copyOf

copyOf

copyOf

copyOf

copyOf

copyOf

copyOf

copyOf

copyOf

copyOfRange

copyOfRange

copyOfRange

copyOfRange

copyOfRange

copyOfRange

java.util
クラス Arrays