java.util
클래스 Vector<E>

java.lang.Object 
  java.util.AbstractCollection <E>
      java.util.AbstractList <E>
          java.util.Vector<E>

모든 구현된 인터페이스:

Serializable, Cloneable, Iterable <E>, Collection <E>, List <E>, RandomAccess

알려진 직계 서브 클래스:

Stack

public class Vector<E>
extends AbstractList <E>
implements List <E>, RandomAccess,
 Cloneable,
 Serializable 

Vector 클래스는 객체의 가변장 배열을 구현합니다. 여기에는 배열과 같이, 정수 인덱스를 사용해 액세스 할 수 있는 요소가 포함되어 있습니다. 그러나, Vector 사이즈는 작성 후에 추가 및 삭제된 객체를 포함할 수 있도록 필요에 따라서 늘리거나 줄이거나 할 수 있습니다 .

각 Vector는 capacity (용량)와 capacityIncrement (증가량)를 관리하는 것으로써 기억 관리를 최적화하려고 합니다. capacity는 항상 Vector 요소수에 가까운 값이며, 일반적으로 요소수부터 커집니다. 이것은 Vector에 요소가 더해질 때, Vector 기억 영역은 capacityIncrement 만 늘려지기 때문입니다. 많은 요소를 삽입하기 전에 어플리케이션으로 용량을 필요한 값으로 설정해 두면, 메모리의 재배분의 회수를 줄일 수가 있습니다.

Java 2 플랫폼 v1. 2 에서는 이 클래스는 List를 구현하기 위해서 개량되고 있기 때문에 Java Collections Framework 일부가 됩니다. 새로운 컬렉션의 구현과는 달라, Vector는 동기를 잡습니다.

Vector 메서드 Iterator 및 listIterator가 돌려주는 Iterator는 「페이르파스트」입니다. Iterator 작성 후에 Iterator 자체의 remove 또는 add 메서드 이외 방법으로 Vector를 구조적으로 변경하면, Iterator는 ConcurrentModificationException을 Throw 합니다. 따라서, 동시에 변경을 하면, Iterator는 장래의 예측할 수 없는 시점에 있어 예측할 수 없는 동작이 발생하는 위험을 회피하기 위해서 즉시 한편 솜씨 자주 예외를 Throw 합니다. Vector elements 메서드가 돌려주는 Enumeration는 페이르파스트가 아닙니다.

보통, 비동기의 동시 변경이 있는 경우, 확실한 보증을 실시하는 것은 불가능해서, 반복자의 페이르파스트의 동작을 보증할 수 없습니다. 페이르파스트 반복자는 최선 노력 원칙에 기반해 ConcurrentModificationException을 Throw 합니다. 따라서, 정확을 기하기 위해서 이 예외에 의존된 프로그램을 쓰는 것은 잘못입니다. 「반복자의 페이르파스트의 동작은 버그를 검출하기 위해서 마셔 사용해야 합니다」

이 클래스는 Java Collections Framework 멤버입니다.

도입된 버전 :

JDK1. 0

관련 항목:

Collection, List, ArrayList, LinkedList, 직렬화 된 형식

필드 개요

protected int	capacityIncrement Vector 사이즈가 Vector 용량을 넘을 때 자동적으로 늘려지는 양입니다.
protected int	elementCount Vector 객체내의 유효한 요소수입니다.
protected Object []	elementData Vector 요소가 포함되는 배열 버퍼입니다.

클래스 java.util. AbstractList 로부터 상속된 필드

modCount

생성자 개요

Vector ()
비어있는 Vector를 작성해, 그 내부 데이터 배열의 사이즈가 10 으로 그 표준적인 증가가 제로이도록 합니다.

Vector (Collection <? extends E > c)
지정된 컬렉션의 반복자가 돌려준 순서로 그 요소를 포함하는 Vector를 작성합니다.

Vector (int initialCapacity)
지정된 초기 용량 및 증가량이 제로인, 비어있는 Vector를 작성합니다.

Vector (int initialCapacity, int capacityIncrement)
지정된 용량과 증가량으로 비어있는 Vector를 작성합니다.

메서드 개요

boolean	add (E o) Vector 말미로 지정된 요소를 추가합니다.
void	add (int index, E element) Vector 내의 지정된 위치로 지정된 요소를 삽입합니다.
boolean	addAll (Collection <? extends E > c) 지정된 Collection 내의 모든 요소를 이 Vector 말미에 그 Collection Iterator에 의해 리턴된 순서로 추가합니다.
boolean	addAll (int index, Collection <? extends E > c) 지정된 Collection 내의 모든 요소를, Vector 지정된 위치에 삽입합니다.
void	addElement (E obj) 지정된 요소를 Vector 마지막에 추가해, 사이즈를 1 늘립니다.
int	capacity () Vector 새로운 용량을 리턴합니다.
void	clear () 모든 요소를 Vector 로부터 삭제합니다.
Object	clone () Vector를 카피합니다.
boolean	contains (Object elem) 지정된 객체가 Vector 요소일지 어떨지를 판정합니다.
boolean	containsAll (Collection <? > c) Vector가 지정된 Collection 내의 모든 요소를 보관 유지하는 경우에 true를 리턴합니다.
void	copyInto (Object [] anArray) Vector 요소를, 지정된 배열에 카피합니다.
E	elementAt (int index) 지정된 인덱스의 요소를 리턴합니다.
Enumeration <E >	elements () Vector 요소의 열거를 리턴합니다.
void	ensureCapacity (int minCapacity) Vector 수용량을 필요에 따라서 늘려, 적어도 최소 수용량의 인수로 지정되는 요소수를 보관 유지할 수 있는 것을 보증합니다.
boolean	equals (Object o) 지정된 Object가 Vector와 동일한지 어떤지를 비교합니다.
E	firstElement () Vector 최초의 요소 (인덱스 0 항목)를 리턴합니다.
E	get (int index) Vector 내의 지정된 위치에 있는 요소를 리턴합니다.
int	hashCode () Vector 해시 코드값을 리턴합니다.
int	indexOf (Object elem) equals 메서드를 사용해 동일한지 어떤지를 판정하면서, 지정된 인수와 같은 내용의 요소를 선두로부터 검색합니다.
int	indexOf (Object elem, int index) equals 메서드를 사용해 동일한지 어떤지를 판정하면서, 지정된 인수와 같은 내용의 요소가 지정된 index로 부터 검색합니다.
void	insertElementAt (E obj, int index) Vector 지정된 index에 지정된 객체를 요소로서 삽입합니다.
boolean	isEmpty () Vector가 요소를 가지지 않는지 어떤지를 판정합니다.
E	lastElement () Vector 마지막 요소를 리턴합니다.
int	lastIndexOf (Object elem) Vector를 말미로부터 검색해, 지정된 객체와 같은 내용의 요소의 인덱스를 리턴합니다.
int	lastIndexOf (Object elem, int index) 지정된 인덱스로부터 후 방향으로 지정된 객체를 검색해, 검출된 인덱스를 리턴합니다.
E	remove (int index) Vector 내의 지정된 위치에 있는 요소를 삭제합니다.
boolean	remove (Object o) Vector 내에서 최초로 검출된 지정된 요소를 삭제합니다.
boolean	removeAll (Collection <? > c) Vector 로부터, 지정된 Collection 내에 보관 유지 떠날 수 있어 모든 요소를 삭제합니다.
void	removeAllElements () Vector 로부터 모든 요소를 삭제해, 사이즈를 0 으로 설정합니다.
boolean	removeElement (Object obj) 최초로 검출된 (최소 인덱스의) 인수의 요소를 Vector 로부터 삭제합니다.
void	removeElementAt (int index) 지정된 인덱스의 요소를 삭제합니다.
protected void	removeRange (int fromIndex, int toIndex) fromIndex (이것을 포함한다) ~ toIndex (이것을 포함하지 않는다)의 범위의 인덱스를 가지는 모든 요소를 이 List 로부터 삭제합니다.
boolean	retainAll (Collection <? > c) 지정된 Collection 내에 보관 유지되고 있는 Vector 내의 요소만을 보관 유지합니다.
E	set (int index, E element) Vector 내의 지정된 위치에 있는 요소를, 지정된 요소로 옮겨놓습니다.
void	setElementAt (E obj, int index) Vector 지정된 index 요소에 지정된 객체를 설정합니다.
void	setSize (int newSize) Vector 사이즈를 설정합니다.
int	size () Vector 요소수를 리턴합니다.
List <E >	subList (int fromIndex, int toIndex) 이 List, fromIndex (이것을 포함한다)와 toIndex (이것을 포함하지 않는다)의 사이의 부분의 뷰를 리턴합니다.
Object []	toArray () Vector 내의 모든 요소를 올바른 순서로 보관 유지하는 배열을 리턴합니다.
<T> T[]	toArray (T[] a) Vector 내의 모든 요소가 올바른 순서로 포함되고 있는 배열을 리턴합니다.
String	toString () 각 요소의 String 표현을 보관 유지하고 있는 Vector 캐릭터 라인 표현을 리턴합니다.
void	trimToSize () Vector 용량을 현재의 용량에까지 줄입니다.

클래스 java.util. AbstractList 로부터 상속된 메서드

iterator, listIterator, listIterator

클래스 java.lang. Object 로부터 상속된 메서드

finalize, getClass, notify, notifyAll, wait, wait, wait

인터페이스 java.util. List 로부터 상속된 메서드

iterator, listIterator, listIterator

필드의 상세

elementData

protected Object [] elementData

Vector 요소가 포함되는 배열 버퍼입니다. Vector 용량은 이 배열 버퍼의 길이로 적어도 Vector 모든 요소를 포함하는데 충분한 크기가 필요합니다.

Vector 내의 마지막 요소의 뒤에 오는 배열 요소는 null 입니다.

elementCount

protected int elementCount

Vector 객체내의 유효한 요소수입니다. elementData[0] ~ elementData[elementCount-1] 요소가 실제의 항목입니다.

capacityIncrement

protected int capacityIncrement

Vector 사이즈가 Vector 용량을 넘을 때 자동적으로 늘려지는 양입니다. 용량의 증가량이 제로 아래의 경우, 확대의 필요가 있을 때마다 Vector 용량은 배가 됩니다.

생성자 상세

Vector

public Vector(int initialCapacity,
              int capacityIncrement)

지정된 용량과 증가량으로 비어있는 Vector를 작성합니다.

파라미터:

initialCapacity - Vector 초기 용량

capacityIncrement - Vector가 넘쳤을 때에 증가되는 용량

예외:

IllegalArgumentException - 지정된 초기 용량이 부의 경우

Vector

public Vector(int initialCapacity)

지정된 초기 용량 및 증가량이 제로인, 비어있는 Vector를 작성합니다.

파라미터:

initialCapacity - Vector 초기 용량

예외:

IllegalArgumentException - 지정된 초기 용량이 부의 경우

Vector

public Vector()

비어있는 Vector를 작성해, 그 내부 데이터 배열의 사이즈가 10 으로 그 표준적인 증가가 제로이도록 합니다.

Vector

public Vector(Collection <?  extends E > c)

지정된 컬렉션의 반복자가 돌려준 순서로 그 요소를 포함하는 Vector를 작성합니다.

파라미터:

c - 요소가 Vector에 배치되는 컬렉션

예외:

NullPointerException - 지정된 컬렉션이 null 인 경우

도입된 버전 :

1.2

메서드의 상세

copyInto

public void copyInto(Object [] anArray)

Vector 요소를, 지정된 배열에 카피합니다. Vector 내의 인덱스 k 항목이 anArray 요소 k에 복사됩니다. 배열은 Vector 내에 모든 객체를 보관 유지하는데 충분한 크기가 아니면 안됩니다. 그렇지 않은 경우는 IndexOutOfBoundsException이 발생 됩니다.

파라미터:

anArray - 카피한 요소를 포함하는 배열

예외:

NullPointerException - 지정된 배열이 null 인 경우

trimToSize

public void trimToSize()

Vector 용량을 현재의 용량에까지 줄입니다. Vector 용량이 현재의 용량보다 큰 경우, elementData 필드에 보관 유지되고 있는 그 내부 데이터 배열을 작은 것에 옮겨놓는 것으로 용량을 현재의 사이즈에 동일해지도록 변경합니다. 어플리케이션으로 이 조작을 실시하면 Vector 메모리 사용량을 최소로 할 수 있습니다.

ensureCapacity

public void ensureCapacity(int minCapacity)

Vector 수용량을 필요에 따라서 늘려, 적어도 최소 수용량의 인수로 지정되는 요소수를 보관 유지할 수 있는 것을 보증합니다.

Vector 현재의 용량이 minCapacity 보다 작은 경우, elementData 필드에 보관 유지되고 있는 그 내부 데이터 배열을 보다 큰 데이터 배열에 옮겨놓아 그 용량을 늘립니다. 새로운 데이터 배열의 사이즈는 capacityIncrement가 제로 이하가 아닌 한, 원의 사이즈에 그 값을 더한 것이 됩니다. capacityIncrement가 제로 아래의 경우는 새로운 용량은 원의 용량의 2 배가 됩니다. 새로운 사이즈가 아직 minCapacity 보다 작은 경우에는 새로운 용량은 minCapacity가 됩니다.

파라미터:

minCapacity - 보증하고 싶은 최소 용량

setSize

public void setSize(int newSize)

Vector 사이즈를 설정합니다. 새로운 사이즈가 현재의 사이즈보다 큰 경우는 새로운 null 요소가 Vector 마지막에 추가됩니다. 현재의 사이즈보다 작은 경우는 인덱스 newSize와 그 이후의 요소는 모두 파기됩니다.

파라미터:

newSize - Vector 새로운 사이즈

예외:

ArrayIndexOutOfBoundsException - 사이즈가 잘못된 값 의 경우

capacity

public int capacity()

Vector 새로운 용량을 리턴합니다.

반환값:

현재의 용량 (Vector elementData 필드에 보관 유지되고 있는 그 내부 데이터 배열의 길이)

size

public int size()

Vector 요소수를 리턴합니다.

정의:

인터페이스 Collection <E > 내의 size

정의:

인터페이스 List <E > 내의 size

정의:

클래스 AbstractCollection <E > 내의 size

반환값:

Vector 요소수

isEmpty

public boolean isEmpty()

Vector가 요소를 가지지 않는지 어떤지를 판정합니다.

정의:

인터페이스 Collection <E > 내의 isEmpty

정의:

인터페이스 List <E > 내의 isEmpty

오버라이드(override):

클래스 AbstractCollection <E > 내의 isEmpty

반환값:

Vector가 요소를 가지고 있지 않은 즉 그 사이즈가 0인 경우에만 true, 그렇지 않은 경우는 false

elements

public Enumeration <E > elements()

Vector 요소의 열거를 리턴합니다. 리턴된 Enumeration 객체는 Vector 모든 항목을 생성합니다. 생성되는 최초의 항목은 인덱스 0 항목, 다음이 인덱스 1 항목등과 같이, 차례차례 생성되어 갑니다.

반환값:

Vector 요소의 열거

관련 항목:

Enumeration, Iterator

contains

public boolean contains(Object  elem)

지정된 객체가 Vector 요소일지 어떨지를 판정합니다.

정의:

인터페이스 Collection <E > 내의 contains

정의:

인터페이스 List <E > 내의 contains

오버라이드(override):

클래스 AbstractCollection <E > 내의 contains

파라미터:

elem - 객체

반환값:

지정된 객체가 equals 메서드에 의해 Vector 내의 요소로 같은이라고 확인되었을 경우에만 true, 그렇지 않은 경우는 false

indexOf

public int indexOf(Object  elem)

equals 메서드를 사용해 동일한지 어떤지를 판정하면서, 지정된 인수와 같은 내용의 요소를 선두로부터 검색합니다.

정의:

인터페이스 List <E > 내의 indexOf

오버라이드(override):

클래스 AbstractList <E > 내의 indexOf

파라미터:

elem - 객체

반환값:

Vector 내에서 최초의 인수의 인덱스, 즉 elem.equals(elementData[k])가 true 인 것 같은 최소값 k. 객체가 발견되지 않는 경우는 -1 이 리턴된

관련 항목:

Object.equals(Object)

indexOf

public int indexOf(Object  elem,
                   int index)

equals 메서드를 사용해 동일한지 어떤지를 판정하면서, 지정된 인수와 같은 내용의 요소가 지정된 index로 부터 검색합니다.

파라미터:

elem - 객체

index - 검색을 개시하는 위치의 부 이외의 인덱스

반환값:

Vector 내에서 위치 index 나 그 이후의 최초의 객체 인수의 인덱스, 즉 elem.equals(elementData[k]) && (k >= index)가 true 인 것 같은 최소값 k. 객체가 발견되지 않는 경우는 -1 이 리턴된다. 「index >= 이 Vector 현재 사이즈」의 경우는 -1 이 리턴된다

예외:

IndexOutOfBoundsException - index가 잘못된 값 의 경우

관련 항목:

Object.equals(Object)

lastIndexOf

public int lastIndexOf(Object  elem)

Vector를 말미로부터 검색해, 지정된 객체와 같은 내용의 요소의 인덱스를 리턴합니다.

정의:

인터페이스 List <E > 내의 lastIndexOf

오버라이드(override):

클래스 AbstractList <E > 내의 lastIndexOf

파라미터:

elem - 설정하는 성분

반환값:

Vector 내에서 마지막에 검출된 지정된 객체의 인덱스, 즉 elem.equals(elementData[k])가 true 인 것 같은 최대값 k. 객체가 발견되지 않는 경우는 -1 이 리턴된다

lastIndexOf

public int lastIndexOf(Object  elem,
                       int index)

지정된 인덱스로부터 후 방향으로 지정된 객체를 검색해, 검출된 인덱스를 리턴합니다.

파라미터:

elem - 설정하는 성분

index - 검색을 개시하는 위치의 인덱스

반환값:

Vector 내에서 위치 index 전에서 가장 근처에 있는 지정된 객체의 인덱스, 즉 elem.equals(elementData[k]) && (k <= index)가 true 인 것 같은 최대값 k. 객체가 발견되지 않는 경우는 -1. index가 잘못된 값 인 경우는 -1

예외:

IndexOutOfBoundsException - index가 Vector 현재의 사이즈보다 큰가 동일한 경우

elementAt

public E  elementAt(int index)

지정된 인덱스의 요소를 리턴합니다.

이 메서드는 기능적으로 get 메서드와 같습니다. 이것은 List 인터페이스의 일부입니다.

파라미터:

index - Vector 인덱스

반환값:

지정된 인덱스의 요소

예외:

ArrayIndexOutOfBoundsException - index가 부의 경우, 또는 Vector 객체의 현재의 사이즈보다 작지 않은 경우

관련 항목:

get(int), List

firstElement

public E  firstElement()

Vector 최초의 요소 (인덱스 0 항목)를 리턴합니다.

반환값:

Vector 최초의 요소

예외:

NoSuchElementException - Vector가 요소를 가지지 않는 경우

lastElement

public E  lastElement()

Vector 마지막 요소를 리턴합니다.

반환값:

Vector 마지막 요소, 즉 인덱스 size() - 1 요소

예외:

NoSuchElementException - Vector가 비어있는 경우

setElementAt

public void setElementAt(E  obj,
                         int index)

Vector 지정된 index 요소에 지정된 객체를 설정합니다. 그 인덱스에 있던 요소는 파기됩니다.

인덱스는 0에 동일한지, 그것보다 큰 값이 아니면 안됩니다. 또, Vector 현재의 사이즈보다 작은 값이 아니면 안됩니다.

이 메서드는 기능적으로 set 메서드와 같습니다. 이것은 List 인터페이스의 일부입니다. 배열의 사용법에 의해 접근하기 위해서 set 메서드가 파라미터의 순서를 반대로 하는 것에 주의해 주세요. 또, set 메서드가 지정된 위치에 포함되고 있던 낡은 값을 돌려주게도 주의해 주세요.

파라미터:

obj - 요소로 설정되는 객체

index - 인덱스

예외:

ArrayIndexOutOfBoundsException - 인덱스가 부정했던 경우

관련 항목:

size(), List, set(int, java.lang.Object)

removeElementAt

public void removeElementAt(int index)

지정된 인덱스의 요소를 삭제합니다. 지정된 index에 동일한지, 그것보다 큰 인덱스의 요소는 모두 1개 전방의 인덱스에 채울 수 있습니다. Vector 사이즈는 1 만 줄여집니다.

인덱스는 0에 동일한지, 그것보다 큰 값이 아니면 안됩니다. 또, Vector 현재의 사이즈보다 작은 값이 아니면 안됩니다.

이 메서드는 기능적으로 remove 메서드와 같습니다. 이것은 List 인터페이스의 일부입니다. remove 메서드가 지정된 위치에 포함되고 있던 낡은 값을 돌려주는 것에 주의해 주세요.

파라미터:

index - 삭제되는 객체의 인덱스

예외:

ArrayIndexOutOfBoundsException - 인덱스가 부정했던 경우

관련 항목:

size(), remove(int), List

insertElementAt

public void insertElementAt(E  obj,
                            int index)

Vector 지정된 index에 지정된 객체를 요소로서 삽입합니다. 지정된 index에 동일한지, 그것보다 큰 인덱스의 요소는 모두 1개 후방의 인덱스에 어긋납니다.

인덱스는 0에 동일한지, 그것보다 큰 값이 아니면 안됩니다. 또, Vector 현재의 사이즈에 동일한지, 그것보다 작은 값이 아니면 안됩니다. 인덱스가 Vector 현재의 사이즈에 동일한 경우, 새로운 요소는 Vector 말미에 추가됩니다.

이 메서드는 기능적으로 add(Object, int) 메서드와 같습니다. 이것은 List 인터페이스의 일부입니다. 배열의 사용법에 의해 적합한 형태로 하기 위해서 add 메서드가 파라미터의 순서를 반대로 하는 것에 주의해 주세요.

파라미터:

obj - 삽입되는 요소

index - 새로운 요소를 삽입하는 위치

예외:

ArrayIndexOutOfBoundsException - 인덱스가 부정했던 경우

관련 항목:

size(), add(int, Object), List

addElement

public void addElement(E  obj)

지정된 요소를 Vector 마지막에 추가해, 사이즈를 1 늘립니다. 사이즈가 Vector 용량보다 커질 때는 용량이 늘려집니다.

이 메서드는 기능적으로 add(Object) 메서드와 같습니다. 이것은 List 인터페이스의 일부입니다.

파라미터:

obj - 추가되는 요소

관련 항목:

add(Object), List

removeElement

public boolean removeElement(Object  obj)

최초로 검출된 (최소 인덱스의) 인수의 요소를 Vector 로부터 삭제합니다. 객체가 검출되면, 그 객체의 인덱스와 같은가 그것보다 큰 인덱스의 요소는 모두 1개 전방의 인덱스에 채울 수 있습니다.

이 메서드는 기능적으로 remove(Object) 메서드와 같습니다. 이것은 List 인터페이스의 일부입니다.

파라미터:

obj - 삭제되는 요소

반환값:

인수가 Vector 요소인 경우는 true, 그렇지 않은 경우는 false

관련 항목:

List.remove(Object), List

removeAllElements

public void removeAllElements()

Vector 로부터 모든 요소를 삭제해, 사이즈를 0 으로 설정합니다.

이 메서드는 기능적으로 clear 메서드와 같습니다. 이것은 List 인터페이스의 일부입니다.

관련 항목:

clear(), List

clone

public Object  clone()

Vector를 카피합니다. 카피는 내부 데이터 배열의 복제에의 참조를 보관 유지하는 것에서 만나며, Vector 객체의 원의 내부 데이터 배열에의 참조를 보관 유지하는 것은 아닙니다.

오버라이드(override):

클래스 Object 내의 clone

반환값:

이 Vector 복제

관련 항목:

Cloneable

toArray

public Object [] toArray()

Vector 내의 모든 요소를 올바른 순서로 보관 유지하는 배열을 리턴합니다.

정의:

인터페이스 Collection <E > 내의 toArray

정의:

인터페이스 List <E > 내의 toArray

오버라이드(override):

클래스 AbstractCollection <E > 내의 toArray

반환값:

컬렉션의 모든 요소가 포함되고 있는 배열

도입된 버전 :

1.2

관련 항목:

Arrays.asList(Object[])

toArray

public <T> T[] toArray(T[] a)

Vector 내의 모든 요소가 올바른 순서로 포함되고 있는 배열을 리턴합니다. 리턴된 배열의 실행시의 형태는 지정된 배열의 형태가 됩니다. 지정된 배열에 Vector가 들어가는 경우는 그 배열에 리턴됩니다 . 그 외의 경우는 지정된 배열의 실행시의 형태와 Vector 사이즈를 사용해 새로운 배열을 할당할 수 있습니다.

Vector가 지정된 배열에 여유를 가지고 들어가는 경우, 즉 배열이 Vector 보다 요소를 많이 가지는 경우, Vector 말미의 직후에 오는 배열내의 요소는 null 로 설정됩니다. 이것은 Vector가 전혀 null 요소를 보관 유지하고 있지 않는 것을 호출해 옆이 인식하고 있는 경우에만, Vector 길이를 확인할 때에 도움이 됩니다.

정의:

인터페이스 Collection <E > 내의 toArray

정의:

인터페이스 List <E > 내의 toArray

오버라이드(override):

클래스 AbstractCollection <E > 내의 toArray

파라미터:

a - 배열이 충분한 크기를 가지는 경우는 Vector 요소가 포함되는 배열. 그렇지 않은 경우는 요소를 포함하기 위해서 같은 실행시의 형태의 새로운 배열을 할당할 수 있다

반환값:

Vector 요소가 포함되고 있는 배열

예외:

ArrayStoreException - a 실행시의 형태가 Vector 내의 각 요소의 실행시의 형태의 슈퍼타입이 아닌 경우

NullPointerException - 지정된 배열이 null 인 경우

도입된 버전 :

1.2

get

public E  get(int index)

Vector 내의 지정된 위치에 있는 요소를 리턴합니다.

정의:

인터페이스 List <E > 내의 get

정의:

클래스 AbstractList <E > 내의 get

파라미터:

index - 리턴된 요소의 인덱스

반환값:

지정된 인덱스에 있는 객체

예외:

ArrayIndexOutOfBoundsException - 인덱스가 범위외의 경우 (index < 0 || index >= size())

도입된 버전 :

1.2

set

public E  set(int index,
             E  element)

Vector 내의 지정된 위치에 있는 요소를, 지정된 요소로 옮겨놓습니다.

정의:

인터페이스 List <E > 내의 set

오버라이드(override):

클래스 AbstractList <E > 내의 set

파라미터:

index - 치환되는 요소의 인덱스

element - 지정된 위치에 포함되는 요소

반환값:

지정된 위치에 이전 있던 요소

예외:

ArrayIndexOutOfBoundsException - 인덱스가 범위외의 경우 (index < 0 || index >= size())

도입된 버전 :

1.2

add

public boolean add(E  o)

Vector 말미로 지정된 요소를 추가합니다.

정의:

인터페이스 Collection <E > 내의 add

정의:

인터페이스 List <E > 내의 add

오버라이드(override):

클래스 AbstractList <E > 내의 add

파라미터:

o - Vector에 추가되는 요소

반환값:

true (Collection.add 범용 규약 대로)

도입된 버전 :

1.2

remove

public boolean remove(Object  o)

Vector 내에서 최초로 검출된 지정된 요소를 삭제합니다. Vector가 요소를 보관 유지하고 있지 않는 경우는 변경되지 않습니다. 즉, (o==null ? get(i) ==null : o.equals(get(i)))인 가장 작은 인덱스 i를 가지는 요소가 있으면 삭제합니다.

정의:

인터페이스 Collection <E > 내의 remove

정의:

인터페이스 List <E > 내의 remove

오버라이드(override):

클래스 AbstractCollection <E > 내의 remove

파라미터:

o - Vector 로부터 삭제되는 요소 (그 요소가 있는 경우)

반환값:

지정된 요소가 Vector 내에 있었을 경우는 true

도입된 버전 :

1.2

add

public void add(int index,
                E  element)

Vector 내의 지정된 위치로 지정된 요소를 삽입합니다. 그 위치와 그 이후에 요소가 있으면 그것들을 오른쪽으로 이동시켜, 각 요소의 인덱스에 1을 더합니다.

정의:

인터페이스 List <E > 내의 add

오버라이드(override):

클래스 AbstractList <E > 내의 add

파라미터:

index - 지정된 요소가 삽입되는 인덱스

element - 삽입되는 요소

예외:

ArrayIndexOutOfBoundsException - 인덱스가 범위외의 경우 (index < 0 || index > size())

도입된 버전 :

1.2

remove

public E  remove(int index)

Vector 내의 지정된 위치에 있는 요소를 삭제합니다. 그 이후에 요소가 있으면 그것들을 왼쪽으로 이동해, 각 요소의 인덱스로부터 1을 줄입니다. Vector 로부터 삭제된 요소를 리턴합니다.

정의:

인터페이스 List <E > 내의 remove

오버라이드(override):

클래스 AbstractList <E > 내의 remove

파라미터:

index - 삭제되는 요소의 인덱스

반환값:

삭제된 요소

예외:

ArrayIndexOutOfBoundsException - 인덱스가 범위외의 경우 (index < 0 || index >= size())

도입된 버전 :

1.2

clear

public void clear()

모든 요소를 Vector 로부터 삭제합니다. 이 호출이 돌아가면, 그것이 예외를 Throw 하지 않는 한, Vector는 비웁니다.

정의:

인터페이스 Collection <E > 내의 clear

정의:

인터페이스 List <E > 내의 clear

오버라이드(override):

클래스 AbstractList <E > 내의 clear

도입된 버전 :

1.2

containsAll

public boolean containsAll(Collection <? > c)

Vector가 지정된 Collection 내의 모든 요소를 보관 유지하는 경우에 true를 리턴합니다.

정의:

인터페이스 Collection <E > 내의 containsAll

정의:

인터페이스 List <E > 내의 containsAll

오버라이드(override):

클래스 AbstractCollection <E > 내의 containsAll

파라미터:

c - 요소가 이 Vector에 있을지 어떨지를 조사하는 컬렉션

반환값:

Vector가 지정된 컬렉션내의 모든 요소를 보관 유지하는 경우는 true

예외:

NullPointerException - 지정된 컬렉션이 null 인 경우

관련 항목:

AbstractCollection.contains(Object)

addAll

public boolean addAll(Collection <?  extends E > c)

지정된 Collection 내의 모든 요소를 이 Vector 말미에 그 Collection Iterator에 의해 리턴된 순서로 추가합니다. 이 오퍼레이션의 동작은 지정된 Collection가 오퍼레이션의 진행시로 변경된다고 정의되지 않습니다. 이것은 그 Collection가 Vector 인 경우에 이 호출의 동작이 정의되지 않고, Vector가 비어있지 않은 것을 나타냅니다.

정의:

인터페이스 Collection <E > 내의 addAll

정의:

인터페이스 List <E > 내의 addAll

오버라이드(override):

클래스 AbstractCollection <E > 내의 addAll

파라미터:

c - Vector에 삽입되는 요소

반환값:

이 호출의 결과, 이 Vector가 변경되었을 경우는 true

예외:

NullPointerException - 지정된 컬렉션이 null 인 경우

도입된 버전 :

1.2

관련 항목:

AbstractCollection.add(Object)

removeAll

public boolean removeAll(Collection <? > c)

Vector 로부터, 지정된 Collection 내에 보관 유지 떠날 수 있어 모든 요소를 삭제합니다.

정의:

인터페이스 Collection <E > 내의 removeAll

정의:

인터페이스 List <E > 내의 removeAll

오버라이드(override):

클래스 AbstractCollection <E > 내의 removeAll

파라미터:

c - Vector 로부터 삭제되는 요소의 컬렉션

반환값:

Vector가 호출의 결과로서 변경되었을 경우는 true

예외:

NullPointerException - 지정된 컬렉션이 null 인 경우

도입된 버전 :

1.2

관련 항목:

AbstractCollection.remove(Object), AbstractCollection.contains(Object)

retainAll

public boolean retainAll(Collection <? > c)

지정된 Collection 내에 보관 유지되고 있는 Vector 내의 요소만을 보관 유지합니다. 즉, Vector 로부터, 지정된 Collection 내에 보관 유지되어 있지 않은 모든 요소를 삭제합니다.

정의:

인터페이스 Collection <E > 내의 retainAll

정의:

인터페이스 List <E > 내의 retainAll

오버라이드(override):

클래스 AbstractCollection <E > 내의 retainAll

파라미터:

c - Vector에 보관 유지되고 있는 요소의 컬렉션 (다른 모든 요소는 삭제)

반환값:

Vector가 호출의 결과로서 변경되었을 경우는 true

예외:

NullPointerException - 지정된 컬렉션이 null 인 경우

도입된 버전 :

1.2

관련 항목:

AbstractCollection.remove(Object), AbstractCollection.contains(Object)

addAll

public boolean addAll(int index,
                      Collection <?  extends E > c)

지정된 Collection 내의 모든 요소를, Vector 지정된 위치에 삽입합니다. 그 위치와 그 이후에 요소가 있는 경우는 그것들을 오른쪽으로 이동해, 각 요소의 인덱스에 1을 더합니다. 새로운 각 요소는 지정된 Collection 반복자에 의해 리턴된 순서로 Vector 내에 표시됩니다.

정의:

인터페이스 List <E > 내의 addAll

오버라이드(override):

클래스 AbstractList <E > 내의 addAll

파라미터:

index - 지정된 컬렉션으로부터 최초의 요소를 삽입하는 위치의 인덱스

c - Vector에 삽입되는 요소

반환값:

이 호출의 결과, 이 Vector가 변경되었을 경우는 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를 리턴합니다. 2개의 요소 e1와 e2는 (e1==null ? e2==null : e1.equals(e2))인 경우에 동일해집니다. 즉, 같은 순서로 같은 요소를 보관 유지하고 있는 경우에 2개의 List는 동일한 것과 판정됩니다.

정의:

인터페이스 Collection <E > 내의 equals

정의:

인터페이스 List <E > 내의 equals

오버라이드(override):

클래스 AbstractList <E > 내의 equals

파라미터:

o - Vector와 같은가 어떤가를 비교되는 Object

반환값:

지정된 Object가 Vector와 동일한 경우는 true

관련 항목:

Object.hashCode(), Hashtable

hashCode

public int hashCode()

Vector 해시 코드값을 리턴합니다.

정의:

인터페이스 Collection <E > 내의 hashCode

정의:

인터페이스 List <E > 내의 hashCode

오버라이드(override):

클래스 AbstractList <E > 내의 hashCode

반환값:

리스트의 해시 코드값

관련 항목:

Object.equals(java.lang.Object), Hashtable

toString

public String  toString()

각 요소의 String 표현을 보관 유지하고 있는 Vector 캐릭터 라인 표현을 리턴합니다.

오버라이드(override):

클래스 AbstractCollection <E > 내의 toString

반환값:

이 컬렉션의 캐릭터 라인 표현

subList

public List <E > subList(int fromIndex,
                       int toIndex)

이 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가 흐트러졌을 경우입니다.

정의:

인터페이스 List <E > 내의 subList

오버라이드(override):

클래스 AbstractList <E > 내의 subList

파라미터:

fromIndex - subList 하단점 (이것을 포함한다)

toIndex - subList 상단점 (이것을 포함하지 않는다)

반환값:

이 List 내의 지정된 범위의 뷰

예외:

IndexOutOfBoundsException - 단 점의 인덱스값이 범위외의 경우 (fromIndex < 0 || toIndex > size)

IllegalArgumentException - 단 점의 인덱스값이 부정한 경우 (fromIndex > toIndex)

removeRange

protected void removeRange(int fromIndex,
                           int toIndex)

fromIndex (이것을 포함한다) ~ toIndex (이것을 포함하지 않는다)의 범위의 인덱스를 가지는 모든 요소를 이 List 로부터 삭제합니다. 후속의 요소는 왼쪽으로 이동합니다 (인덱스값이 감소). 이 호출에의해 (toIndex - fromIndex)의 요소수만큼 ArrayList가 짧아집니다. toIndex==fromIndex인 경우, 이 오퍼레이션은 아무것도 실시하지 않습니다.

오버라이드(override):

클래스 AbstractList <E > 내의 removeRange

파라미터:

fromIndex - 삭제하는 최초의 요소의 인덱스

toIndex - 삭제하는 마지막 요소의 직후의 인덱스