java.util
인터페이스 List

모든 슈퍼 인터페이스:

Collection

기존의 구현 클래스의 일람:

AbstractList , ArrayList , LinkedList , Vector

public interface List

extends Collection

순서 붙일 수 있었던 콜렉션입니다. 「순차 순서」라고도 불립니다. 이 인터페이스의 유저는 리스트내의 어디에 각 요소가 삽입될까를 정밀하게 제어할 수 있습니다. 유저는 정수치의 인덱스 (리스트내의 위치)에 의해 요소에 액세스 하거나 리스트내의 요소를 검색하거나 할 수가 있습니다.

세트와는 달라, 통상, 리스트는 중복 하는 요소를 허가합니다. 즉, 리스트는 통상 e1.equals(e2) 가 되는 것 같은 e1 와 e2 의 요소의 페어를 허가합니다. 또, null 요소를 허가하는 경우에는 통상은 복수의 null 요소를 허가합니다. 유저가 중복 하는 값을 삽입하려고 했을 때에 실행시의 예외를 슬로우 하는 것으로써, 중복 하는 값을 금지하는 리스트를 구현하는 경우도 있습니다만, 이와 같이 사용되는 것은 거의 없습니다.

List 인터페이스는 iterator,add,remove,equals, 및 hashCode 의 각 메소드의 규약에 대해서,Collection 인터페이스로 지정되고 있는 것에 가세해 한층 더 조항을 추가합니다. 다른 계승 메소드의 선언도 편의상 여기에 포함됩니다.

List 인터페이스는 위치를 지정해 (인덱스로) 리스트의 요소에 액세스하기 위한 4 개의 메소드를 제공합니다. Java 배열과 같게, List 의 인덱스는 0 으로부터 시작됩니다. 일부의 구현 (LinkedList 클래스등)에서는 이러한 오퍼레이션의 실행에는 인덱스치 에 비례한 시간이 걸리는 경우가 있습니다. 이 때문에, 호출측이 이러한 구현에 대해 모르는 경우는 리스트에 인덱스를 붙이는 것보다도, 리스트내의 요소의 반복 처리를 행해 주세요.

List 인터페이스는 Iterator 인터페이스가 제공하는 통상의 오퍼레이션에 가세해, 요소의 삽입, 치환, 및 쌍방향 액세스를 가능하게 하는 ListIterator 라고 하는 특수한 반복자를 제공합니다. 리스트내의 지정한 위치로부터 개시하는 리스트 반복자를 취득하기 위한 메소드가 제공되고 있습니다.

List 인터페이스는 지정한 오브젝트를 검색하기 위한 2 개의 메소드를 제공합니다. 퍼포먼스의 관점으로부터는 이러한 메소드는 주의해 사용할 필요가 있습니다. 많은 구현으로 이러한 메소드는 시간이 걸리는 선형 탐색을 실행합니다.

리스트내의 임의의 위치에 복수의 요소를 효율적으로 삽입 및 삭제하기 위해서,List 인터페이스는 2 개의 메소드를 제공합니다.

주: 리스트에 리스트 자체를 요소로서 저장하는 일도 가능합니다만, 충분히 주의해 주세요. 그러한 리스트에서는 equals 메소드 및 hashCode 메소드의 동작은 프로텍션되지 않습니다.

리스트의 구현에는 저장할 수 있는 요소에 제한이 있는 것도 있습니다. 예를 들어, null 요소를 금지하는 구현이나, null 요소의 형태에 제한이 있는 구현도 있습니다. 부적당한 요소를 추가하려고 하면(자), 통상 NullPointerException 또는 ClassCastException 와 같은 체크되지 않는 예외가 슬로우 합니다. 부적당한 요소를 조회하려고 하면(자), 예외를 슬로우 하는 경우나, 다만 false 를 돌려주는 경우도 있습니다. 전의 동작을 금지하는 구현도 있으면, 후의 동작을 금지하는 구현도 있습니다. 좀 더 일반적으로 말하면(자), 리스트에의 삽입이 되지 않는 부적당한 요소를 처리하려고 하면(자), 예외가 슬로우 되는 경우나, 처리가 유효하게 되는 경우가 있습니다. 이 인터페이스에 관한 그러한 예외는 「임의」의 사양으로서 마크 됩니다.

도입된 버젼:

1.2

관련 항목:

Collection , Set , ArrayList , LinkedList , Vector , Arrays.asList(Object[]) , Collections.nCopies(int, Object) , Collections.EMPTY_LIST , AbstractList , AbstractSequentialList

메소드의 개요

void	add (int index, Object element) 리스트내의 지정된 위치에, 지정된 요소를 삽입합니다 (임의의 오퍼레이션).
boolean	add (Object o) 지정된 요소를 리스트의 마지막에 추가합니다 (임의의 오퍼레이션).
boolean	addAll (Collection c) 지정된 콜렉션내의 모든 요소를, 지정된 콜렉션의 반복자에 의해 돌려주어지는 순서로 리스트의 마지막에 추가합니다 (임의의 오퍼레이션).
boolean	addAll (int index, Collection c) 지정된 콜렉션내의 모든 요소를, 리스트의 지정된 위치에 삽입합니다 (임의의 오퍼레이션).
void	clear () 모든 요소를 리스트로부터 삭제합니다 (임의의 오퍼레이션).
boolean	contains (Object o) 리스트로 지정된 요소가 포함되어 있는 경우에 true 를 돌려줍니다.
boolean	containsAll (Collection c) 지정된 콜렉션의 모든 요소가 리스트에 포함되어 있는 경우에 true 를 돌려줍니다.
boolean	equals (Object o) 지정된 오브젝트가 리스트와 동일한지 어떤지를 비교합니다.
Object	get (int index) 리스트내의 지정된 위치에 있는 요소를 돌려줍니다.
int	hashCode () 리스트의 해시 코드치를 돌려줍니다.
int	indexOf (Object o) 지정된 요소가 리스트내에서 최초로 검출된 위치의 인덱스를 돌려줍니다.
boolean	isEmpty () 리스트에 요소가 없는 경우에 true 를 돌려줍니다.
Iterator	iterator () 이 리스트내의 요소를 적절한 순서로 반복 처리 하는 반복자를 돌려줍니다.
int	lastIndexOf (Object o) 지정된 요소가 리스트내에서 마지막에 검출된 위치의 인덱스를 돌려줍니다.
ListIterator	listIterator () 리스트내의 요소를 적절한 순서로 반복 처리 하는 반복자를 돌려줍니다.
ListIterator	listIterator (int index) 리스트내의 요소를 적절한 순서로 반복 처리 하는 리스트내의 지정된 위치로부터 개시하는 반복자를 돌려줍니다.
Object	remove (int index) 리스트내의 지정된 위치에 있는 요소를 삭제합니다 (임의의 오퍼레이션).
boolean	remove (Object o) 리스트내에서 지정된 요소가 최초로 검출되었을 때, 그 요소를 삭제합니다 (임의의 오퍼레이션).
boolean	removeAll (Collection c) 지정된 콜렉션에 저장 떠날 수 있어 모든 요소를 리스트로부터 삭제합니다 (임의의 오퍼레이션).
boolean	retainAll (Collection c) 지정된 콜렉션에 저장되고 있는 요소만이 리스트내에 포함되도록(듯이) 합니다 (임의의 오퍼레이션).
Object	set (int index, Object element) 리스트내의 지정된 위치에 있는 요소를, 지정된 요소에 옮겨놓습니다 (임의의 오퍼레이션).
int	size () 리스트내의 요소수를 돌려줍니다.
List	subList (int fromIndex, int toIndex) 이 리스트의,fromIndex (이것을 포함한다)로부터 toIndex (이것을 포함하지 않는다)의 범위의 부분의 뷰를 돌려줍니다.
Object []	toArray () 리스트내의 모두 요소를 적절한 순서로 저장하고 있는 배열을 돌려줍니다.
Object []	toArray (Object [] a) 리스트내의 모두 요소를 적절한 순서로 저장하고 있는 배열을 돌려줍니다.

메소드의 상세

size

public int size()

리스트내의 요소수를 돌려줍니다. 이 리스트에 Integer.MAX_VALUE 보다 많은 요소가 있는 경우는 Integer.MAX_VALUE 를 돌려줍니다.

정의:

인터페이스 Collection 내의 size

반환값:

리스트내의 요소수

isEmpty

public boolean isEmpty()

리스트에 요소가 없는 경우에 true 를 돌려줍니다.

정의:

인터페이스 Collection 내의 isEmpty

반환값:

리스트가 요소를 1 개나 보관 유지하고 있지 않는 경우는 true

contains

public boolean contains(Object  o)

리스트로 지정된 요소가 포함되어 있는 경우에 true 를 돌려줍니다. 즉, 리스트에,(o==null ? e==null : o.equals(e)) 가 되는 요소 e 가 1 개 이상 포함되어 있는 경우에만 true 를 돌려줍니다.

정의:

인터페이스 Collection 내의 contains

파라미터:

o - 리스트에 있을지 어떨지를 조사하는 요소

반환값:

리스트가, 지정된 요소를 보관 유지하고 있는 경우는 true

예외:

ClassCastException - 지정된 요소의 형태가 이 리스트와 호환이 아닌 경우 (임의의 옵션)

NullPointerException - 지정된 요소가 null 로, 이 리스트가 null 요소를 서포트하지 않는 경우 (임의의 옵션)

iterator

public Iterator  iterator()

이 리스트내의 요소를 적절한 순서로 반복 처리 하는 반복자를 돌려줍니다.

정의:

인터페이스 Collection 내의 iterator

반환값:

리스트내의 요소를 적절한 순서로 반복 처리 하는 반복자

toArray

public Object [] toArray()

리스트내의 모두 요소를 적절한 순서로 저장하고 있는 배열을 돌려줍니다. Collection.toArray 메소드의 일반 규약에 따릅니다.

정의:

인터페이스 Collection 내의 toArray

반환값:

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

관련 항목:

Arrays.asList(Object[])

toArray

public Object [] toArray(Object [] a)

리스트내의 모두 요소를 적절한 순서로 저장하고 있는 배열을 돌려줍니다. 돌려주어지는 배열의 실행시의 형태는 지정된 배열의 형태가 됩니다. Collection.toArray(Object[]) 메소드의 일반 규약에 따릅니다.

정의:

인터페이스 Collection 내의 toArray

파라미터:

a - 리스트의 요소의 저장처의 배열. 배열의 사이즈가 충분하지 않은 경우는 같은 실행시의 형태로 새로운 배열이 저장용으로서 할당할 수 있다

반환값:

리스트의 요소가 저장되고 있는 배열

예외:

ArrayStoreException - 지정된 배열의 실행시의 형태가, 리스트내의 각 요소의 실행시의 형태의 슈퍼타입이 아닌 경우

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

add

public boolean add(Object  o)

지정된 요소를 리스트의 마지막에 추가합니다 (임의의 오퍼레이션).

이 오퍼레이션을 서포트하는 리스트는 리스트에 추가할 수 있는 요소에 제한을 더하는 경우가 있습니다. 특히, 리스트에는 null 요소의 추가를 거부하는 것도 있으면, 추가되는 요소의 형태에 대해 제한을 더하는 것도 있습니다. List 클래스는 List 에 추가할 수 있는 요소에 대해 제약이 있으면, 문서로 그것을 명확하게 지정할 필요가 있습니다.

정의:

인터페이스 Collection 내의 add

파라미터:

o - 리스트에 추가되는 요소

반환값:

true (Collection.add 메소드의 일반 규약에 따른다)

예외:

UnsupportedOperationException - 리스트가 add 메소드를 서포트하고 있지 않는 경우

ClassCastException - 지정된 요소의 클래스를 위해서(때문에), 리스트에 요소를 추가할 수 없는 경우

NullPointerException - 지정된 요소가 null 로, 이 리스트가 null 요소를 서포트하지 않는 경우

IllegalArgumentException - 이 요소의 특성이 원인으로, 이 리스트에 추가할 수 없는 경우

remove

public boolean remove(Object  o)

리스트내에서 지정된 요소가 최초로 검출되었을 때, 그 요소를 삭제합니다 (임의의 오퍼레이션). 리스트에 그 요소가 없는 경우는 변경되지 않습니다. 즉,(o==null ? get(i) ==null : o.equals(get(i))) 가 되는 최소의 인덱스치 i 를 가지는 요소를 삭제합니다 (그러한 요소가 존재하는 경우).

정의:

인터페이스 Collection 내의 remove

파라미터:

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

반환값:

리스트가, 지정된 요소를 보관 유지하고 있는 경우는 true

예외:

ClassCastException - 지정된 요소의 형태가 이 리스트와 호환이 아닌 경우 (임의의 옵션)

NullPointerException - 지정된 요소가 null 로, 이 리스트가 null 요소를 서포트하지 않는 경우 (임의의 옵션)

UnsupportedOperationException - 리스트가 remove 메소드를 서포트하고 있지 않는 경우

containsAll

public boolean containsAll(Collection  c)

지정된 콜렉션의 모든 요소가 리스트에 포함되어 있는 경우에 true 를 돌려줍니다.

정의:

인터페이스 Collection 내의 containsAll

파라미터:

c - 이 리스트에 있을지 어떨지를 조사하는 콜렉션

반환값:

지정된 콜렉션의 모든 요소가 리스트에 포함되어 있는 경우는 true

예외:

ClassCastException - 지정된 콜렉션의 1 개 또는 복수의 요소의 형태가, 이 리스트와 호환이 아닌 경우 (임의의 옵션)

NullPointerException - 지정된 콜렉션이 1 개 또는 복수의null 요소를 포함해, 이 리스트가 null 요소를 서포트하지 않는 경우 (임의의 옵션)

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

관련 항목:

contains(Object)

addAll

public boolean addAll(Collection  c)

지정된 콜렉션내의 모든 요소를, 지정된 콜렉션의 반복자에 의해 돌려주어지는 순서로 리스트의 마지막에 추가합니다 (임의의 오퍼레이션). 지정된 콜렉션이 오퍼레이션의 진행중으로 변경되었을 경우, 이 오퍼레이션의 동작은 프로텍션되지 않습니다. 즉, 지정된 콜렉션이 리스트이며, 리스트가 하늘이 아닌 경우, 이 호출의 동작은 프로텍션되지 않습니다.

정의:

인터페이스 Collection 내의 addAll

파라미터:

c - 요소가 리스트에 추가되는 콜렉션

반환값:

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

예외:

UnsupportedOperationException - 리스트가 addAll 메소드를 서포트하고 있지 않는 경우

ClassCastException - 지정된 콜렉션내의 요소의 클래스가 원인으로, 리스트에 요소를 추가할 수 없는 경우

NullPointerException - 지정된 콜렉션내에 1 개 또는 복수의 null 요소가 포함되지 않고 이 리스트가 null 요소를 서포트하지 않는 경우. 또는 지정된 콜렉션이 null 의 경우

IllegalArgumentException - 지정된 콜렉션내의 요소의 특성이 원인으로, 리스트에 요소를 추가할 수 없는 경우

관련 항목:

add(Object)

addAll

public boolean addAll(int index,
                      Collection  c)

지정된 콜렉션내의 모든 요소를, 리스트의 지정된 위치에 삽입합니다 (임의의 오퍼레이션). 현재 그 위치에 있는 요소와 후속의 요소는 오른쪽으로 이동합니다 (인덱스치가 증가). 새로운 요소는 지정된 콜렉션의 반복자에 의해 돌려주어지는 순서로 리스트에 삽입됩니다. 지정된 콜렉션이 오퍼레이션의 진행중으로 변경되었을 경우, 이 오퍼레이션의 동작은 프로텍션되지 않습니다. 즉, 지정된 콜렉션이 리스트이며, 리스트가 하늘이 아닌 경우, 이 호출의 동작은 프로텍션되지 않습니다.

파라미터:

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

c - 리스트에 삽입되는 요소

반환값:

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

예외:

UnsupportedOperationException - 리스트가 addAll 메소드를 서포트하고 있지 않는 경우

ClassCastException - 지정된 콜렉션의 어떤 것인가의 요소의 클래스가 원인으로, 리스트에 요소를 추가할 수 없는 경우

NullPointerException - 지정된 콜렉션내에 1 개 또는 복수의 null 요소가 포함되지 않고 이 리스트가 null 요소를 서포트하지 않는 경우. 또는 지정된 콜렉션이 null 의 경우

IllegalArgumentException - 지정된 콜렉션의 어떤 것인가의 요소의 특성이 원인으로, 리스트에 요소를 추가할 수 없는 경우

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

removeAll

public boolean removeAll(Collection  c)

지정된 콜렉션에 저장 떠날 수 있어 모든 요소를 리스트로부터 삭제합니다 (임의의 오퍼레이션).

정의:

인터페이스 Collection 내의 removeAll

파라미터:

c - 어느 요소가 리스트로부터 삭제되는지를 정의하는 콜렉션

반환값:

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

예외:

UnsupportedOperationException - 리스트가 removeAll 메소드를 서포트하고 있지 않는 경우

ClassCastException - 이 콜렉션의 1 개 또는 복수의 요소의 형태가, 지정된 리스트와 호환이 아닌 경우 (임의의 옵션)

NullPointerException - 이 리스트가 1 개 또는 복수의 null 요소를 포함해, 지정된 콜렉션이 null 요소를 서포트하지 않는 경우 (임의의 옵션)

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

관련 항목:

remove(Object) , contains(Object)

retainAll

public boolean retainAll(Collection  c)

지정된 콜렉션에 저장되고 있는 요소만이 리스트내에 포함되도록(듯이) 합니다 (임의의 오퍼레이션). 즉, 지정된 콜렉션에 포함되지 않은 요소를 리스트로부터 모두 삭제합니다.

정의:

인터페이스 Collection 내의 retainAll

파라미터:

c - 세트가 보관 유지하는 요소를 정의하는 콜렉션

반환값:

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

예외:

UnsupportedOperationException - 리스트가 retainAll 메소드를 서포트하고 있지 않는 경우

ClassCastException - 이 콜렉션의 1 개 또는 복수의 요소의 형태가, 지정된 리스트와 호환이 아닌 경우 (임의의 옵션)

NullPointerException - 이 리스트가 1 개 또는 복수의 null 요소를 포함해, 지정된 콜렉션이 null 요소를 서포트하지 않는 경우 (임의의 옵션)

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

관련 항목:

remove(Object) , contains(Object)

clear

public void clear()

모든 요소를 리스트로부터 삭제합니다 (임의의 오퍼레이션). 이 호출로부터의 복귀 후, 리스트는 비웁니다 (예외를 슬로우 했을 경우를 제외하다).

정의:

인터페이스 Collection 내의 clear

예외:

UnsupportedOperationException - 리스트가 clear 메소드를 서포트하고 있지 않는 경우

equals

public boolean equals(Object  o)

지정된 오브젝트가 리스트와 동일한지 어떤지를 비교합니다. 지정된 오브젝트도 리스트이며, 사이즈가 같아, 2 개의 리스트의 대응하는 요소가 모두 「동일하다」경우에만 true 를 돌려줍니다. 2 개의 요소 e1 및 e2 는 (e1==null ? e2==null : e1.equals(e2)) 의 경우에 동일하다고 보여집니다. 즉 2 개의 리스트는 같은 요소가 같은 순서로 포함되어 있는 경우에 동일한 것으로서 정의됩니다. 이 정의에 의해,List 인터페이스의 구현이 달라도, equals 메소드가 올바르게 동작하는 것이 프로텍션됩니다.

정의:

인터페이스 Collection 내의 equals

오버라이드(override):

클래스 Object 내의 equals

파라미터:

o - 리스트와 동일한지 어떤지를 비교하는 오브젝트

반환값:

지정된 오브젝트가 리스트와 동일한 경우는 true

관련 항목:

Object.equals(Object) , Set.equals(Object) , equals(Object)

hashCode

public int hashCode()

리스트의 해시 코드치를 돌려줍니다. 리스트의 해시 코드는 다음의 계산의 결과로서 정의됩니다.

  hashCode = 1;
  Iterator i = list.iterator();
  while (i.hasNext()) {
      Object obj = i.next();
      hashCode = 31*hashCode + (obj==null ?  0 : obj.hashCode());
  }
 

이것에 의해,Object.hashCode 의 일반 규약에 의해 요구되도록(듯이), 임의의 2 개의 리스트 list1 와 list2 로,list1.equals(list2) 이면,list1.hashCode() ==list2.hashCode() 가 되는 것이 프로텍션됩니다.

정의:

인터페이스 Collection 내의 hashCode

오버라이드(override):

클래스 Object 내의 hashCode

반환값:

리스트의 해시 코드치

관련 항목:

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

get

public Object  get(int index)

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

파라미터:

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

반환값:

리스트내의 지정된 위치에 있는 요소

예외:

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

set

public Object  set(int index,
                  Object  element)

리스트내의 지정된 위치에 있는 요소를, 지정된 요소에 옮겨놓습니다 (임의의 오퍼레이션).

파라미터:

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

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

반환값:

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

예외:

UnsupportedOperationException - 리스트가 set 메소드를 서포트하고 있지 않는 경우

ClassCastException - 지정된 요소의 클래스를 위해서(때문에), 리스트에 요소를 추가할 수 없는 경우

NullPointerException - 지정된 요소가 null 로, 이 리스트가 null 요소를 서포트하지 않는 경우

IllegalArgumentException - 이 요소의 일부의 특성을 위해서(때문에), 리스트에 요소를 추가할 수 없는 경우

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

add

public void add(int index,
                Object  element)

리스트내의 지정된 위치에, 지정된 요소를 삽입합니다 (임의의 오퍼레이션). 현재 그 위치에 있는 요소와 후속의 요소는 오른쪽으로 이동합니다 (인덱스치에 1 을 가산).

파라미터:

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

element - 삽입되는 요소

예외:

UnsupportedOperationException - 리스트가 add 메소드를 서포트하고 있지 않는 경우

ClassCastException - 지정된 요소의 클래스를 위해서(때문에), 리스트에 요소를 추가할 수 없는 경우

NullPointerException - 지정된 요소가 null 로, 이 리스트가 null 요소를 서포트하지 않는 경우

IllegalArgumentException - 이 요소의 일부의 특성을 위해서(때문에), 리스트에 요소를 추가할 수 없는 경우

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

remove

public Object  remove(int index)

리스트내의 지정된 위치에 있는 요소를 삭제합니다 (임의의 오퍼레이션). 후속의 요소는 왼쪽으로 이동합니다 (인덱스치로부터 1 을 감산). 리스트로부터 삭제된 요소가 돌려주어집니다.

파라미터:

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

반환값:

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

예외:

UnsupportedOperationException - 리스트가 remove 메소드를 서포트하고 있지 않는 경우

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

indexOf

public int indexOf(Object  o)

지정된 요소가 리스트내에서 최초로 검출된 위치의 인덱스를 돌려줍니다. 지정된 요소가 리스트에 없는 경우는 -1 을 돌려줍니다. 즉,(o==null ? get(i) ==null : o.equals(get(i))) 를 채우는 최소의 인덱스치 i 를 돌려줍니다. 그러한 인덱스가 없는 경우는 -1 을 돌려줍니다.

파라미터:

o - 검색하는 요소

반환값:

지정된 요소가 리스트내에서 최초로 검출된 위치의 인덱스. 리스트에 이 요소가 없는 경우는 -1

예외:

ClassCastException - 지정된 요소의 형태가 이 리스트와 호환이 아닌 경우 (임의의 옵션)

NullPointerException - 지정된 요소가 null 로, 이 리스트가 null 요소를 서포트하지 않는 경우 (임의의 옵션)

lastIndexOf

public int lastIndexOf(Object  o)

지정된 요소가 리스트내에서 마지막에 검출된 위치의 인덱스를 돌려줍니다. 지정된 요소가 리스트에 없는 경우는 -1 을 돌려줍니다. 즉,(o==null ? get(i) ==null : o.equals(get(i))) 를 채우는 최대의 인덱스치 i 를 돌려줍니다. 그러한 인덱스가 없는 경우는 -1 을 돌려줍니다.

파라미터:

o - 검색하는 요소

반환값:

지정된 요소가 리스트내에서 마지막에 검출된 위치의 요소의 인덱스. 리스트에 이 요소가 없는 경우는 -1

예외:

ClassCastException - 지정된 요소의 형태가 이 리스트와 호환이 아닌 경우 (임의의 옵션)

NullPointerException - 지정된 요소가 null 로, 이 리스트가 null 요소를 서포트하지 않는 경우 (임의의 옵션)

listIterator

public ListIterator  listIterator()

리스트내의 요소를 적절한 순서로 반복 처리 하는 반복자를 돌려줍니다.

반환값:

리스트내의 요소를 적절한 순서로 반복 처리 하는 반복자

listIterator

public ListIterator  listIterator(int index)

리스트내의 요소를 적절한 순서로 반복 처리 하는 리스트내의 지정된 위치로부터 개시하는 반복자를 돌려줍니다. 지정된 인덱스는 next 메소드의 최초의 호출에 의해 돌려주어지는 최초의 요소를 나타냅니다. previous 메소드의 최초의 호출은 지정된 인덱스로부터 1 을 뺀 값의 인덱스를 가지는 요소를 돌려줍니다.

파라미터:

index - next 메소드의 호출에 의해 리스트 반복자로부터 돌려주어지는 최초의 요소의 인덱스

반환값:

리스트내의 요소를 적절한 순서로 반복 처리 하는 리스트내의 지정된 위치로부터 개시하는 반복자

subList

public List  subList(int fromIndex,
                    int toIndex)

이 리스트의,fromIndex (이것을 포함한다)로부터 toIndex (이것을 포함하지 않는다)의 범위의 부분의 뷰를 돌려줍니다. fromIndex 와 toIndex 가 동일한 경우는 하늘의 리스트가 돌려주어집니다. 돌려주어지는 리스트는 이 리스트에 대응하고 있습니다. 그 때문에, 돌려주어지는 리스트내에서의 비구조적인 변경은 이 리스트에 반영되어 이 리스트내에서의 변경은 돌려주어지는 리스트에 반영됩니다. 돌려주어지는 리스트는 이 리스트에 의해 서포트되고 있는 리스트에 관련하는 옵션의 오퍼레이션을 모두 서포트합니다.

이 메소드는 배열에 일반적으로 볼 수 있는 것 같은 명시적인 범위 조작을 위한 요구를 불필요하게 합니다. 리스트를 요구하는 어떠한 조작도 리스트 전체는 아니고, subList 뷰상에서 조작하는 것으로, 범위 조작으로서 사용할 수 있습니다. 예를 들어, 다음의 관용법은 지정된 범위의 요소를 리스트로부터 삭제합니다.

	    list.subList(from, to). clear();

indexOf 및 lastIndexOf 에서도, 같은 관용법을 작성할 수 있습니다. Collections 클래스의 알고리즘이 모두 subList 에 적용할 수 있습니다.

배킹 리스트 (즉, 이 리스트)의 구조가, 돌려주어진 리스트를 경유하지 않고 로 변경되었을 경우, 이 메소드로 돌려주어진 리스트의 시멘틱스는 프로텍션되지 않습니다. 구조의 변경이란, 리스트의 사이즈가 바뀌는 것 같은 변경이나, 진행중의 반복 처리가 부정한 결과에 끝나는 것 같은 변경입니다.

파라미터:

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

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

반환값:

이 리스트내의 지정된 범위의 뷰

예외:

IndexOutOfBoundsException - 단 점의 인덱스치가 부정한 경우 (fromIndex < 0 || toIndex > size || fromIndex > toIndex)