java.util
클래스 Vector

java.lang.Object 
  |
  +--java.util.AbstractCollection 
        |
        +--java.util.AbstractList 
              |
              +--java.util.Vector

모든 구현 인터페이스:

Cloneable , Collection , List , RandomAccess , Serializable

직계의 기존의 서브 클래스:

Stack

public class Vector

extends AbstractList

implements List , RandomAccess , Cloneable , Serializable

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

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

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

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

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

도입된 버젼:

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 c)
지정된 콜렉션의 반복자가 돌려준 순서로, 그 요소를 저장하는 Vector 를 작성합니다.

Vector (int initialCapacity)
지정된 초기 용량, 및 증가량이 제로인, 하늘의 Vector 를 작성합니다.

Vector (int initialCapacity, int capacityIncrement)
지정된 용량과 증가량으로 하늘의 Vector 를 작성합니다.

메소드의 개요

void	add (int index, Object element) Vector 내의 지정된 위치로 지정의 요소를 삽입합니다.
boolean	add (Object o) Vector 의 말미로 지정의 요소를 추가합니다.
boolean	addAll (Collection c) 지정된 Collection 내의 모든 요소를 이 Vector 의 말미에, 그 Collection 의 Iterator 에 의해 돌려주어지는 순서로 추가합니다.
boolean	addAll (int index, Collection c) 지정된 Collection 내의 모든 요소를, Vector 의 지정된 위치에 삽입합니다.
void	addElement (Object 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 의 요소를, 지정된 배열에 카피합니다.
Object	elementAt (int index) 지정된 인덱스의 요소를 돌려줍니다.
Enumeration	elements () Vector 의 요소의 리스트를 돌려줍니다.
void	ensureCapacity (int minCapacity) Vector 의 수용량을 필요에 따라서 늘려, 적어도 최소 수용량의 인수로 지정되는 요소수를 보관 유지할 수 있는 것을 프로텍션합니다.
boolean	equals (Object o) 지정된 Object 가 Vector 와 동일한지 어떤지를 비교합니다.
Object	firstElement () Vector 의 최초의 요소 (인덱스 0 의 항목)를 돌려줍니다.
Object	get (int index) Vector 내의 지정된 위치에 있는 요소를 돌려줍니다.
int	hashCode () Vector 의 해시 코드치를 돌려줍니다.
int	indexOf (Object elem) equals 메소드를 사용해 동일한지 어떤지를 판정하면서, 지정된 인수와 같은 내용의 요소를 선두로부터 검색합니다.
int	indexOf (Object elem, int index) equals 메소드를 사용해 동일한지 어떤지를 판정하면서, 지정된 인수와 같은 내용의 요소가 지정된 index 로부터 검색합니다.
void	insertElementAt (Object obj, int index) Vector 의 지정된 index 에, 지정된 오브젝트를 요소로서 삽입합니다.
boolean	isEmpty () Vector 가 요소를 가지지 않는지 어떤지를 판정합니다.
Object	lastElement () Vector 의 마지막 요소를 돌려줍니다.
int	lastIndexOf (Object elem) Vector 를 말미로부터 검색해, 지정된 오브젝트와 같은 내용의 요소의 인덱스를 돌려줍니다.
int	lastIndexOf (Object elem, int index) 지정된 인덱스로부터 후 향해로 지정의 오브젝트를 검색해, 검출된 인덱스를 돌려줍니다.
Object	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 내의 요소만을 보관 유지합니다.
Object	set (int index, Object element) Vector 내의 지정된 위치에 있는 요소를, 지정의 요소로 옮겨놓습니다.
void	setElementAt (Object obj, int index) Vector 의 지정된 index 의 요소에, 지정된 오브젝트를 설정합니다.
void	setSize (int newSize) Vector 의 사이즈를 설정합니다.
int	size () Vector 의 요소수를 돌려줍니다.
List	subList (int fromIndex, int toIndex) 이 List 의,fromIndex (이것을 포함한다)와 toIndex (이것을 포함하지 않는다)의 사이의 부분의 뷰를 돌려줍니다.
Object []	toArray () Vector 내의 모든 요소를 올바른 순서로 보관 유지하는 배열을 돌려줍니다.
Object []	toArray (Object [] 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  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 의 요소수를 돌려줍니다.

정의:

인터페이스 List 내의 size

정의:

클래스 AbstractCollection 내의 size

반환값:

Vector 의 요소수

isEmpty

public boolean isEmpty()

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

정의:

인터페이스 List 내의 isEmpty

오버라이드(override):

클래스 AbstractCollection 내의 isEmpty

반환값:

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

elements

public Enumeration  elements()

Vector 의 요소의 리스트를 돌려줍니다. 돌려주어지는 Enumeration 오브젝트는 Vector 의 모든 항목을 생성합니다. 생성되는 최초의 항목은 인덱스 0 의 항목, 다음이 인덱스 1 의 항목등과 같이, 차례차례 생성되어 갑니다.

반환값:

Vector 의 요소의 리스트

관련 항목:

Enumeration , Iterator

contains

public boolean contains(Object  elem)

지정된 오브젝트가 Vector 의 요소일지 어떨지를 판정합니다.

정의:

인터페이스 List 내의 contains

오버라이드(override):

클래스 AbstractCollection 내의 contains

파라미터:

elem - 오브젝트

반환값:

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

indexOf

public int indexOf(Object  elem)

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

정의:

인터페이스 List 내의 indexOf

오버라이드(override):

클래스 AbstractList 내의 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 내의 lastIndexOf

오버라이드(override):

클래스 AbstractList 내의 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 Object  elementAt(int index)

지정된 인덱스의 요소를 돌려줍니다.

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

파라미터:

index - Vector 의 인덱스

반환값:

지정된 인덱스의 요소

예외:

ArrayIndexOutOfBoundsException - index 가 부의 경우, 또는 Vector 오브젝트의 현재의 사이즈보다 작지 않은 경우

관련 항목:

get(int) , List

firstElement

public Object  firstElement()

Vector 의 최초의 요소 (인덱스 0 의 항목)를 돌려줍니다.

반환값:

Vector 의 최초의 요소

예외:

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

lastElement

public Object  lastElement()

Vector 의 마지막 요소를 돌려줍니다.

반환값:

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

예외:

NoSuchElementException - Vector 가 비었을 경우

setElementAt

public void setElementAt(Object  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 kr 전방의 인덱스에 채울 수 있습니다. Vector 의 사이즈는 1 만 줄여집니다.

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

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

파라미터:

index - 삭제되는 오브젝트의 인덱스

예외:

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

관련 항목:

size() , remove(int) , List

insertElementAt

public void insertElementAt(Object  obj,
                            int index)

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

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

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

파라미터:

obj - 삽입되는 요소

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

예외:

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

관련 항목:

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

addElement

public void addElement(Object  obj)

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

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

파라미터:

obj - 추가되는 요소

관련 항목:

add(Object) , List

removeElement

public boolean removeElement(Object  obj)

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

이 메소드는 기능적으로 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 내의 모든 요소를 올바른 순서로 보관 유지하는 배열을 돌려줍니다.

정의:

인터페이스 List 내의 toArray

오버라이드(override):

클래스 AbstractCollection 내의 toArray

반환값:

리스트내의 모두 요소를 적절한 순서로 저장하고 있는 배열

도입된 버젼:

1.2

관련 항목:

Arrays.asList(Object[])

toArray

public Object [] toArray(Object [] a)

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

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

정의:

인터페이스 List 내의 toArray

오버라이드(override):

클래스 AbstractCollection 내의 toArray

파라미터:

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

반환값:

Vector 의 요소가 저장되고 있는 배열

예외:

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

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

도입된 버젼:

1.2

get

public Object  get(int index)

Vector 내의 지정된 위치에 있는 요소를 돌려줍니다.

정의:

인터페이스 List 내의 get

정의:

클래스 AbstractList 내의 get

파라미터:

index - 돌려주어지는 요소의 인덱스

반환값:

지정된 인덱스에 있는 오브젝트

예외:

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

도입된 버젼:

1.2

set

public Object  set(int index,
                  Object  element)

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

정의:

인터페이스 List 내의 set

오버라이드(override):

클래스 AbstractList 내의 set

파라미터:

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

element - 지정된 위치에 저장되는 요소

반환값:

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

예외:

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

도입된 버젼:

1.2

add

public boolean add(Object  o)

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

정의:

인터페이스 List 내의 add

오버라이드(override):

클래스 AbstractList 내의 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 를 가지는 요소가 있으면 삭제합니다.

정의:

인터페이스 List 내의 remove

오버라이드(override):

클래스 AbstractCollection 내의 remove

파라미터:

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

반환값:

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

도입된 버젼:

1.2

add

public void add(int index,
                Object  element)

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

정의:

인터페이스 List 내의 add

오버라이드(override):

클래스 AbstractList 내의 add

파라미터:

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

element - 삽입되는 요소

예외:

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

도입된 버젼:

1.2

remove

public Object  remove(int index)

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

정의:

인터페이스 List 내의 remove

오버라이드(override):

클래스 AbstractList 내의 remove

파라미터:

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

반환값:

삭제된 요소

예외:

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

도입된 버젼:

1.2

clear

public void clear()

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

정의:

인터페이스 List 내의 clear

오버라이드(override):

클래스 AbstractList 내의 clear

도입된 버젼:

1.2

containsAll

public boolean containsAll(Collection  c)

Vector 가 지정의 Collection 내의 모든 요소를 보관 유지하는 경우에 true 를 돌려줍니다.

정의:

인터페이스 List 내의 containsAll

오버라이드(override):

클래스 AbstractCollection 내의 containsAll

파라미터:

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

반환값:

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

예외:

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

관련 항목:

contains(Object)

addAll

public boolean addAll(Collection  c)

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

정의:

인터페이스 List 내의 addAll

오버라이드(override):

클래스 AbstractCollection 내의 addAll

파라미터:

c - Vector 에 삽입되는 요소

반환값:

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

예외:

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

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

도입된 버젼:

1.2

관련 항목:

List.add(Object)

removeAll

public boolean removeAll(Collection  c)

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

정의:

인터페이스 List 내의 removeAll

오버라이드(override):

클래스 AbstractCollection 내의 removeAll

파라미터:

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

반환값:

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

예외:

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

도입된 버젼:

1.2

관련 항목:

List.remove(Object) , List.contains(Object)

retainAll

public boolean retainAll(Collection  c)

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

정의:

인터페이스 List 내의 retainAll

오버라이드(override):

클래스 AbstractCollection 내의 retainAll

파라미터:

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

반환값:

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

예외:

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

도입된 버젼:

1.2

관련 항목:

List.remove(Object) , List.contains(Object)

addAll

public boolean addAll(int index,
                      Collection  c)

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

정의:

인터페이스 List 내의 addAll

오버라이드(override):

클래스 AbstractList 내의 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 는 동일한 것과 판정됩니다.

정의:

인터페이스 List 내의 equals

오버라이드(override):

클래스 AbstractList 내의 equals

파라미터:

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

반환값:

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

hashCode

public int hashCode()

Vector 의 해시 코드치를 돌려줍니다.

정의:

인터페이스 List 내의 hashCode

오버라이드(override):

클래스 AbstractList 내의 hashCode

반환값:

리스트의 해시 코드치

관련 항목:

Object.hashCode() , Object.equals(Object) , List.equals(Object)

toString

public String  toString()

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

오버라이드(override):

클래스 AbstractCollection 내의 toString

반환값:

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

subList

public List  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 내의 subList

오버라이드(override):

클래스 AbstractList 내의 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 내의 removeRange

파라미터:

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

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