クラスVector<E>
- 型パラメータ:
E- 構成要素の型
- すべての実装されたインタフェース:
Serializable,Cloneable,Iterable<E>,Collection<E>,List<E>,RandomAccess,SequencedCollection<E>
- 直系の既知のサブクラス:
Stack
Vectorクラスは、オブジェクトの可変長配列を実装します。 ここには配列と同じように、整数インデックスを使ってアクセスできる要素が格納されています。 しかし、Vectorのサイズは、Vectorの作成後に追加および削除された項目を格納できるように必要に応じて増やしたり減らしたりすることができます。
各ベクトルは、capacityとcapacityIncrementを維持することによって記憶領域の管理を最適化しようとします。 capacityは常にベクトルのサイズ以上であり、通常はより大きくなります。これは、ベクトルにコンポーネントが追加されるとき、ベクトルの記憶領域はcapacityIncrementずつかたまりで増やされるからです。 多くの要素を挿入する前にアプリケーションで容量を必要な値に設定しておけば、メモリーの再配分の回数を減らすことができます。
このクラスのiteratorおよびlistIteratorメソッドによって返されるイテレータは、fail-fastです: イテレータが作成された後の任意の時点でベクトルが構造的に変更される場合、イテレータ独自のremoveメソッドまたはaddメソッドを使用した場合を除き、イテレータはConcurrentModificationExceptionをスローします。 このように、並行して変更が行われると、イテレータは、将来の予測できない時点において予測できない動作が発生する危険を回避するために、ただちにかつ手際よく例外をスローします。 elementsメソッドによって返されるEnumerationsは、高速ではありません。Vectorが列挙の作成後に構造的に変更された場合、列挙の結果は未定義です。
通常、非同期の並行変更がある場合、確かな保証を行うことは不可能なので、イテレータのフェイルファストの動作を保証することはできません。 フェイルファスト・イテレータは、ベスト・エフォート・ベースでConcurrentModificationExceptionをスローします。 したがって、正確を期すためにこの例外に依存するプログラムを書くことは誤りです。イテレータのフェイルファストの動作はバグを検出するためにのみ使用すべきです。
このクラスは、Java 2プラットフォームv1.2の時点でListインタフェースを実装するように改良された結果、Java Collections Frameworkのメンバーとなりました。 新しいコレクションの実装とは異なり、Vectorは同期をとります。 スレッドセーフな実装が必要ない場合は、Vectorの代わりにArrayListを使用することをお薦めします。
- 導入されたバージョン:
- 1.0
- 関連項目:
-
フィールドのサマリー
フィールド修飾子と型フィールド説明protected intVectorのサイズがVectorの容量を超えるときに自動的に増やされる量です。protected intこのVectorオブジェクト内の有効なコンポーネントの数です。protected Object[]Vectorの要素が格納される配列バッファです。クラスjava.util.AbstractListで宣言されたフィールド
modCount -
コンストラクタのサマリー
コンストラクタ -
メソッドのサマリー
修飾子と型メソッド説明voidVector内の指定された位置に指定された要素を挿入します。booleanVectorの末尾に指定の要素を追加します。booleanaddAll(int index, Collection<? extends E> c) 指定されたCollection内のすべての要素を、Vectorの指定された位置に挿入します。booleanaddAll(Collection<? extends E> c) 指定されたCollection内のすべての要素をこのVectorの末尾に、そのCollectionのIteratorによって返される順序で追加します。voidaddElement(E obj) 指定された要素をVectorの最後に追加し、サイズを1増やします。intcapacity()Vectorの現在の容量を返します。voidclear()すべての要素をVectorから削除します。clone()Vectorをコピーします。boolean指定された要素がこのベクトルに含まれている場合にtrueを返します。booleancontainsAll(Collection<?> c) Vectorが指定のCollection内のすべての要素を保持する場合にtrueを返します。voidVectorの要素を、指定された配列にコピーします。elementAt(int index) 指定されたインデックスの要素を返します。elements()このVectorの要素を列挙したリストを返します。voidensureCapacity(int minCapacity) Vectorの収容量を必要に応じて増やして、少なくとも最小収容量の引数で指定される要素数を保持できることを保証します。boolean指定されたObjectがVectorと等しいかどうかを比較します。このベクトルの最初のコンポーネント(インデックス0にある項目)を返します。voidIterableの各要素に対して指定されたアクションを、すべての要素が処理されるか、アクションが例外をスローするまで実行します。get(int index) Vector内の指定された位置にある要素を返します。inthashCode()Vectorのハッシュ・コード値を返します。int指定された要素がベクトル内で最初に検出された位置のインデックスを返します。指定された要素がベクトルにない場合は -1を返します。int指定された要素をこのベクトル内でindexから順方向に検索して、最初に検出された位置のインデックスを返します。要素が見つからない場合は -1を返します。voidinsertElementAt(E obj, int index) 指定されたオブジェクトを、このベクトル内の指定されたindexの位置にコンポーネントとして挿入します。booleanisEmpty()Vectorが要素を持たないかどうかを判定します。iterator()このリスト内の要素を適切な順序で反復するイテレータを返します。Vectorの最後の要素を返します。int指定された要素がベクトル内で最後に検出された位置のインデックスを返します。指定された要素がベクトルにない場合は -1を返します。intlastIndexOf(Object o, int index) 指定された要素をこのベクトル内でindexから逆方向に検索して、最後に検出された位置のインデックスを返します。要素が見つからない場合は -1を返します。このリスト内の要素を(適切な順序で)反復するリスト・イテレータを返します。listIterator(int index) リスト内の指定された位置で始まる、リスト内の要素を(適切な順序で)反復するリスト・イテレータを返します。remove(int index) ベクトルの指定された位置にある要素を削除します。booleanVector内で最初に検出された指定された要素を削除します。booleanremoveAll(Collection<?> c) Vectorから、指定されたCollection内に保持されているすべての要素を削除します。voidVectorからすべての要素を削除し、サイズを0に設定します。booleanremoveElement(Object obj) 最初に検出された(最小インデックスの)引数の要素をVectorから削除します。voidremoveElementAt(int index) 指定されたインデックスのコンポーネントを削除します。boolean指定された述語(オプションの操作)を満たす、このコレクションのすべての要素を削除します。protected voidremoveRange(int fromIndex, int toIndex) fromIndex(これを含む)からtoIndex(これを含まない)の範囲のインデックスを持つすべての要素をこのリストから削除します。voidreplaceAll(UnaryOperator<E> operator) このリストの各要素を、その要素(オプションの操作)に演算子を適用した結果に置き換えます。booleanretainAll(Collection<?> c) 指定されたCollection内に保持されている、Vector内の要素だけを保持します。Vector内の指定された位置にある要素を、指定の要素で置き換えます。voidsetElementAt(E obj, int index) このベクトルの指定されたindexにあるコンポーネントが指定されたオブジェクトになるように設定します。voidsetSize(int newSize) Vectorのサイズを設定します。intsize()Vectorの要素数を返します。このリスト内の要素に対する遅延バインディングおよびフェイルファストSpliteratorを作成します。subList(int fromIndex, int toIndex) このListの、fromIndex (これを含む)とtoIndex (これを含まない)の間の部分のビューを返します。Object[]toArray()Vector内のすべての要素を正しい順序で保持する配列を返します。<T> T[]toArray(T[] a) Vector内のすべての要素が正しい順序で格納されている配列を返します。返される配列の実行時の型は指定された配列の型になります。toString()各要素のString表現を保持している、Vectorの文字列表現を返します。voidVectorの容量を、現在の容量にまで減らします。インタフェースjava.util.Collectionで宣言されたメソッド
parallelStream, stream, toArrayインタフェースjava.util.Listで宣言されたメソッド
addFirst, addLast, getFirst, getLast, removeFirst, removeLast, reversed, sort
-
フィールド詳細
-
elementData
protected Object[] elementDataVectorの要素が格納される配列バッファです。 Vectorの容量はこの配列バッファの長さで、少なくともVectorのすべての要素を格納するのに十分な大きさが必要です。Vector内の最後の要素の後に来る配列要素はnullです。
-
elementCount
protected int elementCountこのVectorオブジェクト内の有効なコンポーネントの数です。elementData[0]からelementData[elementCount-1]までの要素が実際の項目となります。 -
capacityIncrement
protected int capacityIncrementVectorのサイズがVectorの容量を超えるときに自動的に増やされる量です。 容量の増加量がゼロ以下の場合、拡大の必要があるたびにVectorの容量は倍になります。
-
-
コンストラクタの詳細
-
Vector
public Vector(int initialCapacity, int capacityIncrement) 指定された容量と増加量で空のベクトルを作成します。- パラメータ:
initialCapacity- ベクトルの初期容量capacityIncrement- ベクトルがオーバーフローした際の容量の増加量- スロー:
IllegalArgumentException- 指定された初期容量が負の場合
-
Vector
public Vector(int initialCapacity) 指定された初期容量、および増加量がゼロである、空のベクトルを作成します。- パラメータ:
initialCapacity- ベクトルの初期容量- スロー:
IllegalArgumentException- 指定された初期容量が負の場合
-
Vector
public Vector()空のベクトルを作成し、その内部データ配列のサイズが10で、その標準的な増分がゼロであるようにします。 -
Vector
public Vector(Collection<? extends E> c) 指定されたコレクションのイテレータが返した順序で、その要素を格納するVectorを作成します。- パラメータ:
c- 要素がこのベクトルに配置されるコレクション- スロー:
NullPointerException- 指定されたコレクションがnullである場合- 導入されたバージョン:
- 1.2
-
-
メソッドの詳細
-
copyInto
public void copyInto(Object[] anArray) Vectorの要素を、指定された配列にコピーします。 このベクトル内のインデックスkの項目が、anArrayのコンポーネントkにコピーされます。- パラメータ:
anArray- コピーしたコンポーネントをコピーする配列- スロー:
NullPointerException- 指定された配列がnullである場合IndexOutOfBoundsException- 指定された配列が小さすぎて、このベクトルのすべてのコンポーネントを格納できない場合ArrayStoreException- このベクトルのあるコンポーネントが、指定された配列に格納できる実行時の型ではない場合- 関連項目:
-
trimToSize
public void trimToSize()Vectorの容量を、現在の容量にまで減らします。 このベクトルの容量が現在のサイズよりも大きい場合、elementDataフィールドに保持されているその内部データ配列を小さいものに置き換えることで、容量を現在のサイズに等しくなるように変更します。 アプリケーションでこの操作を行うとVectorのメモリー使用量を最小にできます。 -
ensureCapacity
public void ensureCapacity(int minCapacity) Vectorの収容量を必要に応じて増やして、少なくとも最小収容量の引数で指定される要素数を保持できることを保証します。このベクトルの現在の容量が
minCapacityよりも小さい場合、elementDataフィールドに保持されているその内部データ配列を大きいものに置き換えることで、容量を増やします。 新しいデータ配列のサイズは、capacityIncrementがゼロ以下でないかぎり、元のサイズにその値を加えたものになります。capacityIncrementがゼロ以下の場合は新しい容量は元の容量の2倍になります。新しいサイズがまだminCapacityよりも小さい場合には、新しい容量はminCapacityになります。- パラメータ:
minCapacity- 目的の最小容量
-
setSize
public void setSize(int newSize) Vectorのサイズを設定します。 新しいサイズが現在のサイズより大きい場合は、新しいnull項目がベクトルの最後に追加されます。 新しいサイズが現在のサイズより小さい場合、インデックスnewSize以降のすべてのコンポーネントが破棄されます。- パラメータ:
newSize- このベクトルの新しいサイズ- スロー:
ArrayIndexOutOfBoundsException- 新しいサイズが負の値の場合
-
capacity
public int capacity()Vectorの現在の容量を返します。- 戻り値:
- 現在の容量(このベクトルの
elementDataフィールドに保持されている、その内部データ配列の長さ)
-
size
-
isEmpty
public boolean isEmpty()Vectorが要素を持たないかどうかを判定します。- 定義:
isEmpty、インタフェースCollection<E>- 定義:
isEmpty、インタフェースList<E>- オーバーライド:
isEmpty、クラスAbstractCollection<E>- 戻り値:
- このベクトルがコンポーネントを持っていない場合、つまりサイズがゼロの場合にかぎり
true、そうでない場合はfalse。
-
elements
public Enumeration<E> elements()このVectorの要素を列挙したリストを返します。 返されるEnumerationオブジェクトは、このベクトルのすべての項目を生成します。 最初に生成される項目はインデックス0の項目、次に生成される項目はインデックス1の項目、といった具合になります。 要素の列挙中にベクトルが構造的に変更された場合、列挙の結果は未定義です。- 戻り値:
- Vectorの要素のリスト
- 関連項目:
-
contains
public boolean contains(Object o) 指定された要素がこのベクトルに含まれている場合にtrueを返します。 より正式には、このベクトルにObjects.equals(o, e)などの要素eが少なくとも1つ含まれている場合にのみ、trueを返します。- 定義:
contains、インタフェースCollection<E>- 定義:
contains、インタフェースList<E>- オーバーライド:
contains、クラスAbstractCollection<E>- パラメータ:
o- このベクトル内にあるかどうかが判定される要素- 戻り値:
- 指定された要素がこのベクトルに含まれている場合は
true
-
indexOf
public int indexOf(Object o) 指定された要素がベクトル内で最初に検出された位置のインデックスを返します。指定された要素がベクトルにない場合は -1を返します。 より正式には、Objects.equals(o, get(i))のように最も低い索引iを戻し、そのような索引がない場合は -1を戻します。 -
indexOf
public int indexOf(Object o, int index) 指定された要素をこのベクトル内でindexから順方向に検索して、最初に検出された位置のインデックスを返します。要素が見つからない場合は -1を返します。 より正式には、(i >= index && Objects.equals(o, get(i)))のように最も低い索引iを戻し、そのような索引がない場合は -1を戻します。- パラメータ:
o- 検索する要素index- 検索開始位置のインデックス- 戻り値:
- このベクトル内の
index以降の位置で、要素が最初に現れる位置のインデックス。要素が見つからない場合は-1。 - スロー:
IndexOutOfBoundsException- 指定されたインデックスが負の値の場合- 関連項目:
-
lastIndexOf
public int lastIndexOf(Object o) 指定された要素がベクトル内で最後に検出された位置のインデックスを返します。指定された要素がベクトルにない場合は -1を返します。 より正式には、Objects.equals(o, get(i))のように最も高い索引iを戻し、そのような索引がない場合は -1を戻します。- 定義:
lastIndexOf、インタフェースList<E>- オーバーライド:
lastIndexOf、クラスAbstractList<E>- パラメータ:
o- 検索する要素- 戻り値:
- 指定された要素がベクトル内で最後に検出された位置のインデックス。指定された要素がベクトルにない場合は -1
-
lastIndexOf
public int lastIndexOf(Object o, int index) 指定された要素をこのベクトル内でindexから逆方向に検索して、最後に検出された位置のインデックスを返します。要素が見つからない場合は -1を返します。 より正式には、(i <= index && Objects.equals(o, get(i)))のように最も高い索引iを戻し、そのような索引がない場合は -1を戻します。- パラメータ:
o- 検索する要素index- 逆方向の検索開始位置のインデックス- 戻り値:
- このベクトル内の
index以前の位置で、要素が最後に現れる位置のインデックス。要素が見つからない場合は -1。 - スロー:
IndexOutOfBoundsException- 指定されたインデックスが、このベクトルの現在のサイズ以上である場合
-
elementAt
public E elementAt(int index) - パラメータ:
index- このベクトルのインデックス- 戻り値:
- 指定されたインデックスのコンポーネント
- スロー:
ArrayIndexOutOfBoundsException- インデックスが範囲外の場合(index < 0||index>= size())
-
firstElement
public E firstElement()このベクトルの最初のコンポーネント(インデックス0にある項目)を返します。- 戻り値:
- Vectorの最初の要素
- スロー:
NoSuchElementException- このベクトルがコンポーネントを持たない場合
-
lastElement
public E lastElement()Vectorの最後の要素を返します。- 戻り値:
- ベクトルの最後のコンポーネント、すなわちインデックス
size() - 1のコンポーネント - スロー:
NoSuchElementException- このベクトルが空の場合
-
setElementAt
public void setElementAt(E obj, int index) このベクトルの指定されたindexにあるコンポーネントが指定されたオブジェクトになるように設定します。 そのインデックスにあった要素は破棄されます。インデックスの値は、
0以上で、ベクトルの現在のサイズよりも小さくする必要があります。このメソッドは機能的に
set(int, E)メソッド(Listインタフェースの一部)と同じです。 配列の使い方により適した形にするためにsetメソッドがパラメータの順序を逆にすることに注意してください。 また、setメソッドが指定された位置に格納されていた古い値を返すことにも注意してください。- パラメータ:
obj- コンポーネントに設定されるオブジェクトindex- 指定するインデックス- スロー:
ArrayIndexOutOfBoundsException- インデックスが範囲外の場合(index < 0||index>= size())
-
removeElementAt
public void removeElementAt(int index) 指定されたインデックスのコンポーネントを削除します。 このベクトル内にある各コンポーネントのうち、指定されたindexと等しいか、それより大きいインデックスを持つものはすべて前方に移動し、そのインデックスの値は以前より1つ小さい値になります。 このベクトルのサイズは1だけ減らされます。インデックスの値は、
0以上で、ベクトルの現在のサイズよりも小さくする必要があります。このメソッドは機能的に
remove(int)メソッド(Listインタフェースの一部)と同じです。removeメソッドが指定された位置に格納されていた古い値を返すことに注意してください。- パラメータ:
index- 削除されるオブジェクトのインデックス- スロー:
ArrayIndexOutOfBoundsException- インデックスが範囲外の場合(index < 0||index>= size())
-
insertElementAt
public void insertElementAt(E obj, int index) 指定されたオブジェクトを、このベクトル内の指定されたindexの位置にコンポーネントとして挿入します。 このベクトル内にある各コンポーネントのうち、指定されたindexと等しいか、それより大きいインデックスを持つものはすべて後方に移動し、そのインデックスの値は以前より1つ大きい値になります。インデックスの値は、
0以上で、ベクトルの現在のサイズ以下にする必要があります。 インデックスがVectorの現在のサイズに等しい場合、新しい要素はVectorの末尾に追加されます。このメソッドは機能的に
add(int, E)メソッド(Listインタフェースの一部)と同じです。 配列の使い方により適した形にするためにaddメソッドがパラメータの順序を逆にすることに注意してください。- パラメータ:
obj- 挿入されるコンポーネントindex- 新しいコンポーネントを挿入する位置- スロー:
ArrayIndexOutOfBoundsException- インデックスが範囲外の場合(index < 0||index> size())
-
addElement
-
removeElement
public boolean removeElement(Object obj) 最初に検出された(最小インデックスの)引数の要素をVectorから削除します。 オブジェクトが検出されると、そのオブジェクトのインデックスと同じかそれより大きいインデックスの要素はすべて1つ前方のインデックスに詰められます。このメソッドは機能的に
remove(Object)メソッド(Listインタフェースの一部)と同じです。- パラメータ:
obj- 削除されるコンポーネント- 戻り値:
- 引数がこのベクトルのコンポーネントであった場合は
true、そうでない場合はfalse。
-
removeAllElements
-
clone
-
toArray
public Object[] toArray()Vector内のすべての要素を正しい順序で保持する配列を返します。- 定義:
toArray、インタフェースCollection<E>- 定義:
toArray、インタフェースList<E>- オーバーライド:
toArray、クラスAbstractCollection<E>- 戻り値:
- 「ランタイム・コンポーネント・タイプ」が
Objectの配列。このコレクションのすべての要素を含む - 導入されたバージョン:
- 1.2
- 関連項目:
-
toArray
public <T> T[] toArray(T[] a) Vector内のすべての要素が正しい順序で格納されている配列を返します。返される配列の実行時の型は指定された配列の型になります。 指定された配列にVectorが収まる場合は、その配列に返されます。 それ以外の場合は、指定された配列の実行時の型とVectorのサイズを使って新しい配列が割り当てられます。Vectorが指定された配列に余裕をもって収まる場合、つまり配列がVectorよりも要素を数多く持つ場合、Vectorの末尾の直後に来る配列内の要素はnullに設定されます。 このベクトルにnull要素がないことを呼出し側が知っている場合にのみ、この特性を利用してベクトルの長さを判断できます。
- 定義:
toArray、インタフェースCollection<E>- 定義:
toArray、インタフェースList<E>- オーバーライド:
toArray、クラスAbstractCollection<E>- 型パラメータ:
T- 配列要素のタイプ。<E>と同じ型または<E>のスーパー型です。- パラメータ:
a- このベクトルの要素の格納先の配列。配列のサイズが十分でない場合は、同じ実行時の型で新しい配列が格納用として割り当てられる- 戻り値:
- Vectorの要素が格納されている配列
- スロー:
ArrayStoreException-<T>の実行時型が、このベクトル内のすべての要素の実行時型<E>のスーパータイプでない場合NullPointerException- 指定された配列がnullである場合- 導入されたバージョン:
- 1.2
-
get
public E get(int index) Vector内の指定された位置にある要素を返します。- 定義:
get、インタフェースList<E>- 定義:
get、クラスAbstractList<E>- パラメータ:
index- 返される要素のインデックス- 戻り値:
- 指定されたインデックスにあるオブジェクト
- スロー:
ArrayIndexOutOfBoundsException- インデックスが範囲外の場合(index < 0||index>= size())- 導入されたバージョン:
- 1.2
-
set
Vector内の指定された位置にある要素を、指定の要素で置き換えます。- 定義:
set、インタフェースList<E>- オーバーライド:
set、クラスAbstractList<E>- パラメータ:
index- 置換される要素のインデックス。element- 指定された位置に格納される要素。- 戻り値:
- 指定された位置に以前あった要素。
- スロー:
ArrayIndexOutOfBoundsException- インデックスが範囲外の場合(index < 0||index>= size())- 導入されたバージョン:
- 1.2
-
add
public boolean add(E e) Vectorの末尾に指定の要素を追加します。- 定義:
add、インタフェースCollection<E>- 定義:
add、インタフェースList<E>- オーバーライド:
add、クラスAbstractList<E>- パラメータ:
e- このベクトルに追加される要素- 戻り値:
true(Collection.add(E)で指定されているとおり)- 導入されたバージョン:
- 1.2
-
remove
public boolean remove(Object o) Vector内で最初に検出された指定された要素を削除します。 より正式には、Objects.equals(o, get(i))(そのような要素が存在する場合)のように、最も低い索引iの要素を削除します。- 定義:
remove、インタフェースCollection<E>- 定義:
remove、インタフェースList<E>- オーバーライド:
remove、クラスAbstractCollection<E>- パラメータ:
o- このベクトルから削除される要素(その要素が存在する場合)- 戻り値:
- 指定された要素がVector内にあった場合はtrue
- 導入されたバージョン:
- 1.2
-
add
public void add(int index, E element) Vector内の指定された位置に指定された要素を挿入します。 その位置とそれ以降に要素があればそれらを右に移動させ、各要素のインデックスに1を加えます。- 定義:
add、インタフェースList<E>- オーバーライド:
add、クラスAbstractList<E>- パラメータ:
index- 指定の要素が挿入される位置のインデックスelement- 挿入される要素- スロー:
ArrayIndexOutOfBoundsException- インデックスが範囲外の場合(index < 0||index> size())- 導入されたバージョン:
- 1.2
-
remove
public E remove(int index) ベクトルの指定された位置にある要素を削除します。 後続の要素を左に移動します(インデックスから1を減算)。 Vectorから削除された要素を返します。- 定義:
remove、インタフェースList<E>- オーバーライド:
remove、クラスAbstractList<E>- パラメータ:
index- 削除される要素のインデックス- 戻り値:
- 削除された要素
- スロー:
ArrayIndexOutOfBoundsException- インデックスが範囲外の場合(index < 0||index>= size())- 導入されたバージョン:
- 1.2
-
clear
public void clear()すべての要素をVectorから削除します。 この呼出しが返ると、それが例外をスローしないかぎり、Vectorは空になります。- 定義:
clear、インタフェースCollection<E>- 定義:
clear、インタフェースList<E>- オーバーライド:
clear、クラスAbstractList<E>- 導入されたバージョン:
- 1.2
-
containsAll
public boolean containsAll(Collection<?> c) Vectorが指定のCollection内のすべての要素を保持する場合にtrueを返します。- 定義:
containsAll、インタフェースCollection<E>- 定義:
containsAll、インタフェースList<E>- オーバーライド:
containsAll、クラスAbstractCollection<E>- パラメータ:
c- 要素がこのVectorに含まれているかどうかを調べるコレクション- 戻り値:
- Vectorが指定されたコレクション内のすべての要素を保持する場合はtrue
- スロー:
NullPointerException- 指定されたコレクションがnullである場合- 関連項目:
-
addAll
public boolean addAll(Collection<? extends E> c) 指定されたCollection内のすべての要素をこのVectorの末尾に、そのCollectionのIteratorによって返される順序で追加します。 オペレーションの進行中に指定されたCollectionが変更された場合の、このオペレーションの動作は定義されていません。 これは、そのCollectionがVectorである場合にこの呼出しの動作が定義されず、Vectorが空でないことを示します。- 定義:
addAll、インタフェースCollection<E>- 定義:
addAll、インタフェースList<E>- オーバーライド:
addAll、クラスAbstractCollection<E>- パラメータ:
c- このベクトルに挿入される要素- 戻り値:
- このベクトルが呼出しの結果として変更された場合は
true - スロー:
NullPointerException- 指定されたコレクションがnullである場合- 導入されたバージョン:
- 1.2
- 関連項目:
-
removeAll
public boolean removeAll(Collection<?> c) Vectorから、指定されたCollection内に保持されているすべての要素を削除します。- 定義:
removeAll、インタフェースCollection<E>- 定義:
removeAll、インタフェースList<E>- オーバーライド:
removeAll、クラスAbstractCollection<E>- パラメータ:
c- Vectorから削除される要素のコレクション- 戻り値:
- Vectorが呼出しの結果として変更された場合はtrue
- スロー:
ClassCastException- このベクトル内の1つ以上の要素の型が、指定されたコレクションと互換でない場合(オプション)NullPointerException- このベクトルに1つ以上のnull要素が含まれており、指定されたコレクションがnull要素をサポートしない場合(オプション)、または指定されたコレクションがnullの場合- 導入されたバージョン:
- 1.2
- 関連項目:
-
retainAll
public boolean retainAll(Collection<?> c) 指定されたCollection内に保持されている、Vector内の要素だけを保持します。 つまり、Vectorから、指定されたCollection内に保持されていないすべての要素を削除します。- 定義:
retainAll、インタフェースCollection<E>- 定義:
retainAll、インタフェースList<E>- オーバーライド:
retainAll、クラスAbstractCollection<E>- パラメータ:
c- このVectorに保持される要素のコレクション(ほかのすべての要素は削除)- 戻り値:
- Vectorが呼出しの結果として変更された場合はtrue
- スロー:
ClassCastException- このベクトル内の1つ以上の要素の型が、指定されたコレクションと互換でない場合(オプション)NullPointerException- このベクトルに1つ以上のnull要素が含まれており、指定されたコレクションがnull要素をサポートしない場合(オプション)、または指定されたコレクションがnullの場合- 導入されたバージョン:
- 1.2
- 関連項目:
-
removeIf
次のインタフェースからコピーされた説明:Collection指定された述語(オプションの操作)を満たす、このコレクションのすべての要素を削除します。 反復中に、または述語によってスローされたエラーまたは実行時例外は、呼出し側に中継されます。- 定義:
removeIf、インタフェースCollection<E>- パラメータ:
filter- 削除される要素に対してtrueを返す述語- 戻り値:
- 要素が削除された場合は
true - スロー:
NullPointerException- 指定されたフィルタがnullである場合
-
addAll
public boolean addAll(int index, Collection<? extends E> c) 指定されたCollection内のすべての要素を、Vectorの指定された位置に挿入します。 その位置とそれ以降に要素がある場合は、それらを右に移動して、各要素のインデックスに1を加えます。 新しい各要素は、指定されたCollectionのイテレータによって返される順序でVector内に表示されます。- 定義:
addAll、インタフェースList<E>- オーバーライド:
addAll、クラスAbstractList<E>- パラメータ:
index- 指定されたコレクションの最初の要素を挿入する位置のインデックス。c- このベクトルに挿入される要素- 戻り値:
- このベクトルが呼出しの結果として変更された場合は
true - スロー:
ArrayIndexOutOfBoundsException- インデックスが範囲外の場合(index < 0||index> size())NullPointerException- 指定されたコレクションがnullである場合- 導入されたバージョン:
- 1.2
-
equals
public boolean equals(Object o) 指定されたObjectがVectorと等しいかどうかを比較します。 指定されたObjectもListであり、2つのListのサイズが同じで、2つのListの対応する要素がすべて等しい場合にだけtrueを返します。 (e1とe2の2つの要素は、Objects.equals(e1, e2)の場合はequalです。) つまり2つのリストは、同じ要素が同じ順序で含まれている場合に等しいものとして定義されます。- 定義:
equals、インタフェースCollection<E>- 定義:
equals、インタフェースList<E>- オーバーライド:
equals、クラスAbstractList<E>- パラメータ:
o- このVectorと等しいかどうかを比較するObject- 戻り値:
- 指定されたObjectがVectorと等しい場合はtrue
- 関連項目:
-
hashCode
public int hashCode()Vectorのハッシュ・コード値を返します。- 定義:
hashCode、インタフェースCollection<E>- 定義:
hashCode、インタフェースList<E>- オーバーライド:
hashCode、クラスAbstractList<E>- 戻り値:
- このリストのハッシュ・コード値
- 関連項目:
-
toString
public String toString()各要素のString表現を保持している、Vectorの文字列表現を返します。- オーバーライド:
toString、クラスAbstractCollection<E>- 戻り値:
- このコレクションの文字列表現
-
subList
このListの、fromIndex (これを含む)とtoIndex (これを含まない)の間の部分のビューを返します。 fromIndexとtoIndexが等しい場合は、空のListが返されます。 返されるListはこのListに連動しているため、返されるList内での変更はこのListに反映され、このList内での変更は返されるListに反映されます。 返されるListは、このListによってサポートされるすべてのオプションのListオペレーションをサポートします。このメソッドでは、配列に一般的に見られるような、明示的な範囲操作は必要ありません。 リストを要求するいかなる操作もリスト全体ではなく、subListビュー上で操作することで、範囲操作として使用できます。 たとえば、次のイディオムは、ある範囲の要素をリストから削除します。
list.subList(from, to).clear();indexOfおよびlastIndexOfでも、同様のイディオムを作成できます。CollectionsクラスのアルゴリズムがすべてsubListに適用できます。バッキング・リスト(すなわち、このList)が、このメソッドによって返されたListを介さずに構造的に変更された場合、返されたListのセマンティックスは保証されません。 (構造的な変更とは、Listのサイズが変更された場合や、進行中の繰返しにより不正な結果が生じたなどの理由でListが乱れた場合です。)
- 定義:
subList、インタフェースList<E>- オーバーライド:
subList、クラスAbstractList<E>- パラメータ:
fromIndex- subListの下端点(これを含む)toIndex- subListの上端点(これを含まない)- 戻り値:
- このList内の指定された範囲のビュー
- スロー:
IndexOutOfBoundsException- 端点のインデックス値が範囲外の場合(fromIndex < 0||toIndex> size)IllegalArgumentException- 端点のインデックスの順番が正しくない場合(fromIndex> toIndex)
-
removeRange
protected void removeRange(int fromIndex, int toIndex) fromIndex(これを含む)からtoIndex(これを含まない)の範囲のインデックスを持つすべての要素をこのリストから削除します。 後続の要素は左に移動します(インデックス値が減少)。 この呼出しにより、(toIndex - fromIndex)の要素数だけリストが短くなります。toIndex==fromIndexの場合、このオペレーションは何も行いません。- オーバーライド:
removeRange、クラスAbstractList<E>- パラメータ:
fromIndex- 削除する最初の要素のインデックスtoIndex- 削除する最後の要素の直後のインデックス
-
listIterator
public ListIterator<E> listIterator(int index) リスト内の指定された位置で始まる、リスト内の要素を(適切な順序で)反復するリスト・イテレータを返します。 指定されたインデックスは、nextの最初の呼出しによって返される最初の要素を示します。previousの最初の呼出しは、指定されたインデックスから1を引いたインデックスを持つ要素を返します。返されるリスト・イテレータは、フェイルファストです。
- 定義:
listIterator、インタフェースList<E>- オーバーライド:
listIterator、クラスAbstractList<E>- パラメータ:
index- リスト・イテレータから(next呼出しによって)返される最初の要素のインデックス- 戻り値:
- リスト内の指定された位置で始まる、リスト内の要素を(適切な順序で)反復するリスト・イテレータ
- スロー:
IndexOutOfBoundsException- インデックスが範囲外の場合(index < 0||index> size())
-
listIterator
public ListIterator<E> listIterator()このリスト内の要素を(適切な順序で)反復するリスト・イテレータを返します。返されるリスト・イテレータは、フェイルファストです。
- 定義:
listIterator、インタフェースList<E>- オーバーライド:
listIterator、クラスAbstractList<E>- 戻り値:
- このリスト内の要素を(適切な順序で)反復するリスト・イテレータ
- 関連項目:
-
iterator
-
forEach
インタフェースからコピーされた説明:IterableIterableの各要素に対して指定されたアクションを、すべての要素が処理されるか、アクションが例外をスローするまで実行します。 反復の順序でアクションが実行されます(その順序が指定されている場合)。 アクションによってスローされた例外は、呼出し側に中継されます。このメソッドの動作は、オーバーライドするクラスが同時変更ポリシーを指定していないかぎり、要素の基礎となるソースを変更する副作用をアクションが実行する場合には指定されません。
- 定義:
forEach、インタフェースIterable<E>- パラメータ:
action- 各要素に対して実行されるアクション- スロー:
NullPointerException- 指定されたアクションがnullである場合
-
replaceAll
public void replaceAll(UnaryOperator<E> operator) インタフェースからコピーされた説明:Listこのリストの各要素を、その要素(オプションの操作)に演算子を適用した結果に置き換えます。 演算子によってスローされたエラーまたは実行時例外は、呼出し側に中継されます。- 定義:
replaceAll、インタフェースList<E>- パラメータ:
operator- 各要素に適用する演算子- スロー:
NullPointerException- 指定された演算子がnull、または演算子の結果がnull値でこのリストがnull要素を許可しない場合(オプション)
-
spliterator
public Spliterator<E> spliterator()このリスト内の要素に対する遅延バインディングおよびフェイルファストSpliteratorを作成します。Spliteratorは、Spliterator.SIZED、Spliterator.SUBSIZED、およびSpliterator.ORDEREDを報告します。 オーバーライドする実装は、追加の特性値の報告をドキュメント化する必要があります。- 定義:
spliterator、インタフェースCollection<E>- 定義:
spliterator、インタフェースIterable<E>- 定義:
spliterator、インタフェースList<E>- 戻り値:
- このリスト内の要素に対する
Spliterator - 導入されたバージョン:
- 1.8
-