JavaTM Platform
Standard Ed. 6

java.util
���󥿥ե����� List<E>

���٤ƤΥ����ѡ����󥿥ե�����:
Collection<E>, Iterable<E>
���Τμ������饹�ΰ���:
AbstractList, AbstractSequentialList, ArrayList, AttributeList, CopyOnWriteArrayList, LinkedList, RoleList, RoleUnresolvedList, Stack, Vector

public interface List<E>
extends Collection<E>

����դ���줿���쥯�����Ǥ��� �֥������󥹡פȤ�ƤФ�ޤ������Υ��󥿥ե������Υ桼�����ϡ��ꥹ����Τɤ��˳����Ǥ���������뤫����̩������Ǥ��ޤ����桼�����������ͤΥ���ǥå��� (�ꥹ����ΰ���) �ˤ�ä����Ǥ˥������������ꡢ�ꥹ��������Ǥ򸡺������ꤹ�뤳�Ȥ��Ǥ��ޤ���

���åȤȤϰۤʤꡢ�̾�ꥹ�ȤϽ�ʣ�������Ǥ���Ĥ��ޤ����Ĥޤꡢ�ꥹ�Ȥϡ��̾� 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 ���֤����⤢��ޤ��� ����ư���ػߤ�������⤢��С����ư���ػߤ�������⤢��ޤ����⤦��������Ū�˸����ȡ��ꥹ�Ȥؤ�����������ʤ���Ŭ�������Ǥ�������褦�Ȥ���ȡ��㳰���������������⤢��С�������ͭ���ˤʤ���⤢��ޤ������Υ��󥿥ե������˴ؤ��뤽�������㳰�ϡ���Ǥ�աפλ��ͤȤ��ƥޡ�������ޤ���  

���Υ��󥿥ե������ϡ�Java Collections Framework �Υ��С��Ǥ���

Ƴ�����줿�С������:
1.2
��Ϣ����:
Collection, Set, ArrayList, LinkedList, Vector, Arrays.asList(Object[]), Collections.nCopies(int, Object), Collections.EMPTY_LIST, AbstractList, AbstractSequentialList

�᥽�åɤγ���
 boolean add(E e)
          ���ꤵ�줿���Ǥ�ꥹ�ȤκǸ���ɲä��ޤ� (Ǥ�դΥ��ڥ졼�����)��
 void add(int index, E element)
          �ꥹ����λ��ꤵ�줿���֤ˡ����ꤵ�줿���Ǥ��������ޤ� (Ǥ�դΥ��ڥ졼�����)��
 boolean addAll(Collection<? extends E> c)
          ���ꤵ�줿���쥯�������Τ��٤Ƥ����Ǥ򡢻��ꤵ�줿���쥯������ȿ���Ҥˤ�ä��֤�������ǥꥹ�ȤκǸ���ɲä��ޤ� (Ǥ�դΥ��ڥ졼�����)��
 boolean addAll(int index, Collection<? extends E> c)
          ���ꤵ�줿���쥯�������Τ��٤Ƥ����Ǥ򡢥ꥹ�Ȥλ��ꤵ�줿���֤��������ޤ� (Ǥ�դΥ��ڥ졼�����)��
 void clear()
          ���٤Ƥ����Ǥ�ꥹ�Ȥ��������ޤ� (Ǥ�դΥ��ڥ졼�����)��
 boolean contains(Object o)
          �ꥹ�Ȥ˻�������Ǥ�������� true ���֤��ޤ���
 boolean containsAll(Collection<?> c)
          ���ꤵ�줿���쥯�����Τ��٤Ƥ����Ǥ��ꥹ�Ȥ˴ޤޤ�Ƥ������ true ���֤��ޤ���
 boolean equals(Object o)
          ���ꤵ�줿���֥������Ȥ��ꥹ�Ȥ����������ɤ�������Ӥ��ޤ���
 E get(int index)
          �ꥹ����λ��ꤵ�줿���֤ˤ������Ǥ��֤��ޤ���
 int hashCode()
          ���Υꥹ�ȤΥϥå��女�����ͤ��֤��ޤ���
 int indexOf(Object o)
          ���ꤵ�줿���Ǥ��ꥹ����Ǻǽ�˸��Ф��줿���֤Υ���ǥå������֤��ޤ���
 boolean isEmpty()
          �ꥹ�Ȥ����Ǥ��ʤ����� true ���֤��ޤ���
 Iterator<E> iterator()
          ���Υꥹ��������Ǥ�Ŭ�ڤʽ���Ƿ����֤���������ȿ���Ҥ��֤��ޤ���
 int lastIndexOf(Object o)
          ���ꤵ�줿���Ǥ��ꥹ����ǺǸ�˸��Ф��줿���֤Υ���ǥå������֤��ޤ���
 ListIterator<E> listIterator()
          ���Υꥹ��������Ǥ�Ŭ�ڤʽ���Ƿ����֤���������ꥹ��ȿ���Ҥ��֤��ޤ���
 ListIterator<E> listIterator(int index)
          �ꥹ��������Ǥ�Ŭ�ڤʽ���Ƿ����֤��������롢�ꥹ����λ��ꤵ�줿���֤��鳫�Ϥ���ȿ���Ҥ��֤��ޤ���
 E remove(int index)
          �ꥹ����λ��ꤵ�줿���֤ˤ������Ǥ������ޤ� (Ǥ�դΥ��ڥ졼�����)��
 boolean remove(Object o)
          ���ꤵ�줿���Ǥ����Υꥹ�Ȥˤ���С����κǽ�Τ�Τ�ꥹ�Ȥ��������ޤ� (Ǥ�դΥ��ڥ졼�����)��
 boolean removeAll(Collection<?> c)
          ���Υꥹ�Ȥ��顢���ꤵ�줿���쥯�����˴ޤޤ�����Ǥ򤹤٤ƺ�����ޤ� (Ǥ�դΥ��ڥ졼�����)��
 boolean retainAll(Collection<?> c)
          ���ꤵ�줿���쥯�����˳�Ǽ����Ƥ������Ǥ������ꥹ����˴ޤޤ��褦�ˤ��ޤ� (Ǥ�դΥ��ڥ졼�����)��
 E set(int index, E element)
          �ꥹ����λ��ꤵ�줿���֤ˤ������Ǥ򡢻��ꤵ�줿���Ǥ��֤������ޤ� (Ǥ�դΥ��ڥ졼�����)��
 int size()
          �ꥹ����ˤ������Ǥο����֤��ޤ���
 List<E> subList(int fromIndex, int toIndex)
          ���Υꥹ�ȤΡ�fromIndex (�����ޤ�) ���� toIndex (�����ޤޤʤ�) ���ϰϤ���ʬ�Υӥ塼���֤��ޤ���
 Object[] toArray()
          �ꥹ����Τ��٤Ƥ����Ǥ�Ŭ�ڤʽ���� (�ǽ�����Ǥ���Ǹ�����Ǥ�) ��Ǽ���Ƥ���������֤��ޤ���
<T> T[]
toArray(T[] a)
          �ꥹ����Τ��٤Ƥ����Ǥ�Ŭ�ڤʽ���� (�ǽ�����Ǥ���Ǹ�����Ǥ�) ��Ǽ���Ƥ���������֤��ޤ���
 

�᥽�åɤξܺ�

size

int size()
�ꥹ����ˤ������Ǥο����֤��ޤ������Υꥹ�Ȥ� Integer.MAX_VALUE ���¿�������Ǥ�������ϡ�Integer.MAX_VALUE ���֤��ޤ���

���:
���󥿥ե����� Collection<E> ��� size
�����:
�ꥹ��������ǿ�

isEmpty

boolean isEmpty()
�ꥹ�Ȥ����Ǥ��ʤ����� true ���֤��ޤ���

���:
���󥿥ե����� Collection<E> ��� isEmpty
�����:
�ꥹ�Ȥ����Ǥ� 1 �Ĥ��ݻ����Ƥ��ʤ����� true

contains

boolean contains(Object o)
�ꥹ�Ȥ˻�������Ǥ�������� true ���֤��ޤ����Ĥޤꡢ�ꥹ�Ȥˡ�(o==null ? e==null : o.equals(e)) �Ȥʤ����� e �� 1 �İʾ�ޤޤ�Ƥ�����ˤ��� true ���֤��ޤ���

���:
���󥿥ե����� Collection<E> ��� contains
�ѥ�᡼��:
o - �ꥹ�Ȥˤ��뤫�ɤ�����Ĵ�٤�����
�����:
�ꥹ�Ȥ������ꤵ�줿���Ǥ��ݻ����Ƥ������ true
�㳰:
ClassCastException - ���ꤵ�줿���Ǥη��������Υꥹ�Ȥȸߴ��Ǥʤ���� (��ά��ǽ)
NullPointerException - ���ꤵ�줿���Ǥ� null �Ǥ��ꡢ���Υꥹ�Ȥ� null ���Ǥ���Ĥ��ʤ���� (��ά��ǽ)

iterator

Iterator<E> iterator()
���Υꥹ��������Ǥ�Ŭ�ڤʽ���Ƿ����֤���������ȿ���Ҥ��֤��ޤ���

���:
���󥿥ե����� Collection<E> ��� iterator
���:
���󥿥ե����� Iterable<E> ��� iterator
�����:
�ꥹ��������Ǥ�Ŭ�ڤʽ���Ƿ����֤���������ȿ����

toArray

Object[] toArray()
�ꥹ����Τ��٤Ƥ����Ǥ�Ŭ�ڤʽ���� (�ǽ�����Ǥ���Ǹ�����Ǥ�) ��Ǽ���Ƥ���������֤��ޤ���  

�֤��������ؤλ��Ȥ򤳤Υꥹ�Ȥ��ݻ����ʤ��Ȥ������ǡ���������ϰ����Ǥ����Ĥޤꡢ���Υ᥽�åɤϡ��ꥹ�Ȥ������Ϣư���Ƥ�����Ǥ⿷��������������Ƥޤ������Τ��ᡢ�ƤӽФ�¦�ϡ��֤��줿�����ͳ���ѹ��Ǥ��ޤ���  

�᥽�åɤϡ�����١����� API �ȥ��쥯�����١����� API �δ֤ζ��Ϥ���Ȥ��Ƶ�ǽ���ޤ���

���:
���󥿥ե����� Collection<E> ��� toArray
�����:
�ꥹ����Τ��٤Ƥ����Ǥ�Ŭ�ڤʽ���dz�Ǽ���Ƥ�������
��Ϣ����:
Arrays.asList(Object[])

toArray

<T> T[] toArray(T[] a)
�ꥹ����Τ��٤Ƥ����Ǥ�Ŭ�ڤʽ���� (�ǽ�����Ǥ���Ǹ�����Ǥ�) ��Ǽ���Ƥ���������֤��ޤ����֤��������μ¹Ի��η��ϡ����ꤵ�줿����η��ˤʤ�ޤ������ꤵ�줿����˥ꥹ�Ȥ����ޤ���ϡ�����������֤���ޤ�������ʳ��ξ��ϡ����ꤵ�줿����μ¹Ի��η��ȥꥹ�ȤΥ�������Ȥäƿ��������󤬳�����Ƥ��ޤ���  

���ꤵ�줿����˥ꥹ�Ȥ����ޤꡢ��������ˤ����;ʬ���ΰ褬�����硢�Ĥޤ�����˥ꥹ�Ȥ��¿�������Ǥ������硢����ǥꥹ�Ȥ�������³�����Ǥ� null �����ꤵ��ޤ���(����ϡ��ƤӽФ�¦���ꥹ�Ȥ� null ���Ǥ��ޤޤ�Ƥ��ʤ����Ȥ��狼�äƤ�����ˤϡ��ꥹ�Ȥ�Ĺ����Ƚ�ꤹ��Τ����ѤǤ��롣)  

toArray() �᥽�åɤ�Ʊ���褦�ˡ����Υ᥽�åɤϡ�����١����� API �ȥ��쥯�����١����� API �δ֤ζ��Ϥ���Ȥ��Ƶ�ǽ���ޤ�������ˡ����Υ᥽�åɤǤϡ���������μ¹Ի��η������Τ�����Ǥ��뤿�ᡢ�Ķ��ˤ�äƤϳ�����Ƥμ�֤��ޤ��뤳�Ȥ��Ǥ��ޤ���  

x ����ʸ�����������ʤ�ꥹ�ȤǤ��뤳�Ȥ��狼�äƤ���Ȳ��ꤷ�ޤ������Υ����ɤ�Ȥ��ȡ�������������Ƥ�줿 String ������˥ꥹ�Ȥ����פǤ��ޤ���  

     String[] y = x.toArray(new String[0]);
toArray(new Object[0]) �ϡ���ǽ������ toArray() ��Ʊ��Ǥ���

���:
���󥿥ե����� Collection<E> ��� toArray
�ѥ�᡼��:
a - �ꥹ�Ȥ����Ǥγ�Ǽ�����������Υ���������ʬ�Ǥʤ����ϡ�Ʊ���¹Ի��η��ǿ��������󤬳�Ǽ�ѤȤ��Ƴ�����Ƥ���
�����:
�ꥹ�Ȥ����Ǥ���Ǽ����Ƥ�������
�㳰:
ArrayStoreException - ���ꤵ�줿����μ¹Ի��η��������Υꥹ����Τ��٤Ƥ����Ǥμ¹Ի��η��Υ����ѡ������פǤʤ����
NullPointerException - ���ꤵ�줿���� null �Ǥ�����

add

boolean add(E e)
���ꤵ�줿���Ǥ�ꥹ�ȤκǸ���ɲä��ޤ� (Ǥ�դΥ��ڥ졼�����)��  

���Υ��ڥ졼�����򥵥ݡ��Ȥ���ꥹ�Ȥϡ��ꥹ�Ȥ��ɲäǤ������Ǥ����¤�ä����礬����ޤ����äˡ��ꥹ�Ȥˤ� null ���Ǥ��ɲä���ݤ����Τ⤢��С��ɲä�������Ǥη��ˤĤ������¤�ä����Τ⤢��ޤ���List ���饹�ϡ�List ���ɲäǤ������ǤˤĤ������󤬤���С��ɥ�����ȤǤ�������Τ˻��ꤹ��ɬ�פ�����ޤ���

���:
���󥿥ե����� Collection<E> ��� add
�ѥ�᡼��:
e - �ꥹ�Ȥ��ɲä��������
�����:
true (Collection.add(E) �ǻ��ꤵ��Ƥ���Ȥ���)
�㳰:
UnsupportedOperationException - add ���ڥ졼����󤬤��Υꥹ�Ȥǥ��ݡ��Ȥ���ʤ����
ClassCastException - ���ꤵ�줿���ǤΥ��饹�������ǡ����Υꥹ�Ȥˤ������Ǥ��ɲäǤ��ʤ����
NullPointerException - ���ꤵ�줿���Ǥ� null �ǡ����Υꥹ�Ȥ� null ���Ǥ���Ƥ��ʤ����
IllegalArgumentException - �������ǤΥץ��ѥƥ����������ǡ����Υꥹ�Ȥ��ɲäǤ��ʤ����

remove

boolean remove(Object o)
���ꤵ�줿���Ǥ����Υꥹ�Ȥˤ���С����κǽ�Τ�Τ�ꥹ�Ȥ��������ޤ� (Ǥ�դΥ��ڥ졼�����)���ꥹ�Ȥˤ������Ǥ��ʤ����ϡ��ѹ�����ޤ��󡣤Ĥޤꡢ(o==null ? get(i)==null : o.equals(get(i))) �Ȥʤ롢�Ǿ��Υ���ǥå����� i ��������Ǥ������ޤ� (���Τ褦�����Ǥ�¸�ߤ�����)�����ꤵ�줿���Ǥ��ꥹ�Ȥ˴ޤޤ�Ƥ�����硢�Ĥޤꡢ�ƤӽФ��η�̤Ȥ��ƥꥹ�Ȥ��ѹ����줿���� true ���֤��ޤ���

���:
���󥿥ե����� Collection<E> ��� remove
�ѥ�᡼��:
o - �ꥹ�Ȥ�������������� (�������Ǥ�¸�ߤ�����)
�����:
�ꥹ�Ȥ������ꤵ�줿���Ǥ��ݻ����Ƥ������ true
�㳰:
ClassCastException - ���ꤵ�줿���Ǥη��������Υꥹ�Ȥȸߴ��Ǥʤ���� (��ά��ǽ)
NullPointerException - ���ꤵ�줿���Ǥ� null �Ǥ��ꡢ���Υꥹ�Ȥ� null ���Ǥ���Ĥ��ʤ���� (��ά��ǽ)
UnsupportedOperationException - remove ���ڥ졼����󤬤��Υꥹ�Ȥǥ��ݡ��Ȥ���ʤ����

containsAll

boolean containsAll(Collection<?> c)
���ꤵ�줿���쥯�����Τ��٤Ƥ����Ǥ��ꥹ�Ȥ˴ޤޤ�Ƥ������ true ���֤��ޤ���

���:
���󥿥ե����� Collection<E> ��� containsAll
�ѥ�᡼��:
c - ���Υꥹ�Ȥˤ��뤫�ɤ�����Ĵ�٤륳�쥯�����
�����:
���ꤵ�줿���쥯�����Τ��٤Ƥ����Ǥ��ꥹ�Ȥ˴ޤޤ�Ƥ������ true
�㳰:
ClassCastException - ���ꤵ�줿���쥯������ 1 �İʾ�����Ǥη��������Υꥹ�Ȥȸߴ��Ǥʤ���� (��ά��ǽ)
NullPointerException - ���ꤵ�줿���쥯������ 1 �İʾ�� null ���Ǥ��ޤޤ�Ƥ��ꡢ���Υꥹ�Ȥ� null ���Ǥ���Ĥ��ʤ���� (��ά��ǽ)���ޤ��ϻ��ꤵ�줿���쥯����� null �ξ��
��Ϣ����:
contains(Object)

addAll

boolean addAll(Collection<? extends E> c)
���ꤵ�줿���쥯�������Τ��٤Ƥ����Ǥ򡢻��ꤵ�줿���쥯������ȿ���Ҥˤ�ä��֤�������ǥꥹ�ȤκǸ���ɲä��ޤ� (Ǥ�դΥ��ڥ졼�����)�����ڥ졼�����οʹ���ˡ����ꤵ�줿���쥯������ѹ����줿���Ρ����Υ��ڥ졼������ư����������Ƥ��ޤ��󡣤Ĥޤꡢ���ꤵ�줿���쥯����󤬤��Υꥹ�Ȥǡ���������ǤϤʤ����˵�����ޤ���

���:
���󥿥ե����� Collection<E> ��� addAll
�ѥ�᡼��:
c - ���Ǥ��ꥹ�Ȥ��ɲä���륳�쥯�����
�����:
���θƤӽФ��η�̡����Υꥹ�Ȥ��ѹ����줿���� true
�㳰:
UnsupportedOperationException - addAll ���ڥ졼����󤬤��Υꥹ�Ȥǥ��ݡ��Ȥ���ʤ����
ClassCastException - ���ꤵ�줿���쥯�����Τ������ǤΥ��饹�������ǡ����Υꥹ�Ȥˤ��Υ��쥯�������ɲäǤ��ʤ����
NullPointerException - ���ꤵ�줿���쥯������ 1 �İʾ�� null ���Ǥ��ޤޤ�Ƥ��ꡢ���Υꥹ�Ȥ� null ���Ǥ���Ĥ��ʤ���硢�ޤ��ϻ��ꤵ�줿���쥯����� null �ξ��
IllegalArgumentException - ���ꤵ�줿���쥯�����Τ������ǤΤ��������������ǡ����Υꥹ�Ȥˤ��Υ��쥯�������ɲäǤ��ʤ����
��Ϣ����:
add(Object)

addAll

boolean addAll(int index,
               Collection<? extends E> c)
���ꤵ�줿���쥯�������Τ��٤Ƥ����Ǥ򡢥ꥹ�Ȥλ��ꤵ�줿���֤��������ޤ� (Ǥ�դΥ��ڥ졼�����)�����ΰ��֤Ȥ���ʹߤ����Ǥ�������ϡ������򱦤˰�ư���ơ������ǤΥ���ǥå����� 1 ��ä��ޤ������������Ǥϡ����ꤵ�줿���쥯������ȿ���Ҥˤ�ä��֤�������ǥꥹ�Ȥ���������ޤ������ڥ졼�����οʹ���ˡ����ꤵ�줿���쥯������ѹ����줿���Ρ����Υ��ڥ졼������ư����������Ƥ��ޤ��󡣤Ĥޤꡢ���ꤵ�줿���쥯����󤬤��Υꥹ�Ȥǡ���������ǤϤʤ����˵�����ޤ���

�ѥ�᡼��:
index - ���ꤵ�줿���쥯�����κǽ�����Ǥ�����������֤Υ���ǥå���
c - ���Ǥ��ꥹ�Ȥ��ɲä���륳�쥯�����
�����:
���θƤӽФ��η�̡����Υꥹ�Ȥ��ѹ����줿���� true
�㳰:
UnsupportedOperationException - addAll ���ڥ졼����󤬤��Υꥹ�Ȥǥ��ݡ��Ȥ���ʤ����
ClassCastException - ���ꤵ�줿���쥯�����Τ������ǤΥ��饹�������ǡ����Υꥹ�Ȥˤ��Υ��쥯�������ɲäǤ��ʤ����
NullPointerException - ���ꤵ�줿���쥯������ 1 �İʾ�� null ���Ǥ��ޤޤ�Ƥ��ꡢ���Υꥹ�Ȥ� null ���Ǥ���Ĥ��ʤ���硢�ޤ��ϻ��ꤵ�줿���쥯����� null �ξ��
IllegalArgumentException - ���ꤵ�줿���쥯�����Τ������ǤΤ��������������ǡ����Υꥹ�Ȥˤ��Υ��쥯�������ɲäǤ��ʤ����
IndexOutOfBoundsException - ����ǥå������ϰϳ��ξ�� (index < 0 || index > size())

removeAll

boolean removeAll(Collection<?> c)
���Υꥹ�Ȥ��顢���ꤵ�줿���쥯�����˴ޤޤ�����Ǥ򤹤٤ƺ�����ޤ� (Ǥ�դΥ��ڥ졼�����)��

���:
���󥿥ե����� Collection<E> ��� removeAll
�ѥ�᡼��:
c - ���Υꥹ�Ȥ�������������Ǥ�ޤॳ�쥯�����
�����:
���θƤӽФ��η�̡����Υꥹ�Ȥ��ѹ����줿���� true
�㳰:
UnsupportedOperationException - removeAll ���ڥ졼����󤬤��Υꥹ�Ȥǥ��ݡ��Ȥ���ʤ����
ClassCastException - ���Υꥹ�ȤΤ������ǤΥ��饹�������ꤵ�줿���쥯�����ȸߴ��Ǥʤ���� (��ά��ǽ)
NullPointerException - ���Υꥹ����� null ���Ǥ��ޤޤ졢���ꤵ�줿���쥯����� null ���Ǥ���Ĥ��ʤ���� (��ά��ǽ)���ޤ��ϻ��ꤵ�줿���쥯����� null �ξ��
��Ϣ����:
remove(Object), contains(Object)

retainAll

boolean retainAll(Collection<?> c)
���ꤵ�줿���쥯�����˳�Ǽ����Ƥ������Ǥ������ꥹ����˴ޤޤ��褦�ˤ��ޤ� (Ǥ�դΥ��ڥ졼�����)���Ĥޤꡢ���ꤵ�줿���쥯�����˴ޤޤ�Ƥ��ʤ����Ǥ�ꥹ�Ȥ��餹�٤ƺ�����ޤ���

���:
���󥿥ե����� Collection<E> ��� retainAll
�ѥ�᡼��:
c - ���Υꥹ�Ȥ��ݻ���������Ǥ�ޤॳ�쥯�����
�����:
���θƤӽФ��η�̡����Υꥹ�Ȥ��ѹ����줿���� true
�㳰:
UnsupportedOperationException - retainAll ���ڥ졼����󤬤��Υꥹ�Ȥǥ��ݡ��Ȥ���ʤ����
ClassCastException - ���Υꥹ�ȤΤ������ǤΥ��饹�������ꤵ�줿���쥯�����ȸߴ��Ǥʤ���� (��ά��ǽ)
NullPointerException - ���Υꥹ����� null ���Ǥ��ޤޤ졢���ꤵ�줿���쥯����� null ���Ǥ���Ĥ��ʤ���� (��ά��ǽ)���ޤ��ϻ��ꤵ�줿���쥯����� null �ξ��
��Ϣ����:
remove(Object), contains(Object)

clear

void clear()
���٤Ƥ����Ǥ�ꥹ�Ȥ��������ޤ� (Ǥ�դΥ��ڥ졼�����)�����θƤӽФ������ȡ����Υꥹ�Ȥ϶��ˤʤ�ޤ���

���:
���󥿥ե����� Collection<E> ��� clear
�㳰:
UnsupportedOperationException - clear ���ڥ졼����󤬤��Υꥹ�Ȥǥ��ݡ��Ȥ���ʤ����

equals

boolean equals(Object o)
���ꤵ�줿���֥������Ȥ��ꥹ�Ȥ����������ɤ�������Ӥ��ޤ������ꤵ�줿���֥������Ȥ�ꥹ�ȤǤ��ꡢ��������Ʊ���ǡ�2 �ĤΥꥹ�Ȥ��б��������Ǥ����٤ơ��������׾��ˤ��� true ���֤��ޤ���2 �Ĥ����� e1 �� e2 �ϡ�(e1==null ? e2==null :e1.equals(e2)) �Ǥ�������������ʤ�ޤ����Ĥޤ� 2 �ĤΥꥹ�Ȥϡ�Ʊ�����Ǥ�Ʊ������Ǵޤޤ�Ƥ��������������ΤȤ����������ޤ�����������ˤ�ꡢList ���󥿥ե������μ������ۤʤäƤ⡢equals �᥽�åɤ�������ư��뤳�Ȥ��ݾڤ���ޤ���

���:
���󥿥ե����� Collection<E> ��� equals
�����С��饤��:
���饹 Object ��� equals
�ѥ�᡼��:
o - �ꥹ�Ȥ����������ɤ�������Ӥ��륪�֥�������
�����:
���ꤵ�줿���֥������Ȥ��ꥹ�Ȥ����������� true
��Ϣ����:
Object.hashCode(), Hashtable

hashCode

int hashCode()
���Υꥹ�ȤΥϥå��女�����ͤ��֤��ޤ����ꥹ�ȤΥϥå��女���ɤϡ����η׻��η�̤Ȥ����������ޤ���  
  int hashCode = 1;
  Iterator<E> i = list.iterator();
  while (i.hasNext()) {
      E obj = i.next();
      hashCode = 31*hashCode + (obj==null ? 0 : obj.hashCode());
  }
 
����ˤ�ꡢObject.hashCode() �ΰ��̵���ˤ�ä��׵ᤵ���褦�ˡ�Ǥ�դ� 2 �ĤΥꥹ�� list1 �� list2 �ǡ�list1.equals(list2) �Ǥ���С�list1.hashCode()==list2.hashCode() �Ȥʤ뤳�Ȥ��ݾڤ���ޤ���

���:
���󥿥ե����� Collection<E> ��� hashCode
�����С��饤��:
���饹 Object ��� hashCode
�����:
�ꥹ�ȤΥϥå��女������
��Ϣ����:
Object.equals(Object), equals(Object)

get

E get(int index)
�ꥹ����λ��ꤵ�줿���֤ˤ������Ǥ��֤��ޤ���

�ѥ�᡼��:
index - �֤�������ǤΥ���ǥå���
�����:
�ꥹ����λ��ꤵ�줿���֤ˤ�������
�㳰:
IndexOutOfBoundsException - ����ǥå������ϰϳ��ξ�� (index < 0 || index >= size())

set

E set(int index,
      E element)
�ꥹ����λ��ꤵ�줿���֤ˤ������Ǥ򡢻��ꤵ�줿���Ǥ��֤������ޤ� (Ǥ�դΥ��ڥ졼�����)��

�ѥ�᡼��:
index - �ִ���������ǤΥ���ǥå���
element - ���ꤵ�줿���֤˳�Ǽ���������
�����:
���ꤵ�줿���֤˰������ä�����
�㳰:
UnsupportedOperationException - set ���ڥ졼����󤬤��Υꥹ�Ȥǥ��ݡ��Ȥ���ʤ����
ClassCastException - ���ꤵ�줿���ǤΥ��饹�������ǡ����Υꥹ�Ȥˤ������Ǥ��ɲäǤ��ʤ����
NullPointerException - ���ꤵ�줿���Ǥ� null �ǡ����Υꥹ�Ȥ� null ���Ǥ���Ƥ��ʤ����
IllegalArgumentException - ���ꤵ�줿���ǤΤ���ץ��ѥƥ����������ǡ����Υꥹ�Ȥˤ������Ǥ��ɲäǤ��ʤ����
IndexOutOfBoundsException - ����ǥå������ϰϳ��ξ�� (index < 0 || index >= size())

add

void add(int index,
         E element)
�ꥹ����λ��ꤵ�줿���֤ˡ����ꤵ�줿���Ǥ��������ޤ� (Ǥ�դΥ��ڥ졼�����)�����ΰ��֤Ȥ���ʹߤ����Ǥ�����Ф����򱦤˰�ư�����������ǤΥ���ǥå����� 1 ��ä��ޤ���

�ѥ�᡼��:
index - ��������Ǥ������������֤Υ���ǥå���
element - �������������
�㳰:
UnsupportedOperationException - add ���ڥ졼����󤬤��Υꥹ�Ȥǥ��ݡ��Ȥ���ʤ����
ClassCastException - ���ꤵ�줿���ǤΥ��饹�������ǡ����Υꥹ�Ȥˤ������Ǥ��ɲäǤ��ʤ����
NullPointerException - ���ꤵ�줿���Ǥ� null �ǡ����Υꥹ�Ȥ� null ���Ǥ���Ƥ��ʤ����
IllegalArgumentException - ���ꤵ�줿���ǤΤ���ץ��ѥƥ����������ǡ����Υꥹ�Ȥˤ������Ǥ��ɲäǤ��ʤ����
IndexOutOfBoundsException - ����ǥå������ϰϳ��ξ�� (index < 0 || index > size())

remove

E remove(int index)
�ꥹ����λ��ꤵ�줿���֤ˤ������Ǥ������ޤ� (Ǥ�դΥ��ڥ졼�����)����³�����ǤϺ��˰�ư���ޤ� (����ǥå����ͤ��� 1 �򸺻�)���ꥹ�Ȥ��������줿���Ǥ��֤���ޤ���

�ѥ�᡼��:
index - �����������ǤΥ���ǥå���
�����:
���ꤵ�줿���֤˰������ä�����
�㳰:
UnsupportedOperationException - remove ���ڥ졼����󤬤��Υꥹ�Ȥǥ��ݡ��Ȥ���ʤ����
IndexOutOfBoundsException - ����ǥå������ϰϳ��ξ�� (index < 0 || index >= size())

indexOf

int indexOf(Object o)
���ꤵ�줿���Ǥ��ꥹ����Ǻǽ�˸��Ф��줿���֤Υ���ǥå������֤��ޤ��� ���ꤵ�줿���Ǥ��ꥹ�Ȥˤʤ����� -1 ���֤��ޤ����Ĥޤꡢ(o==null ? get(i)==null : o.equals(get(i))) �Ȥʤ롢�Ǿ��Υ���ǥå��� i ���֤��ޤ������Τ褦�ʥ���ǥå�����¸�ߤ��ʤ����� -1 ���֤��ޤ���

�ѥ�᡼��:
o - ������������
�����:
���ꤵ�줿���Ǥ��ꥹ����Ǻǽ�˸��Ф��줿���֤Υ���ǥå������������Ǥ��ꥹ�Ȥˤʤ����� -1
�㳰:
ClassCastException - ���ꤵ�줿���Ǥη��������Υꥹ�Ȥȸߴ��Ǥʤ���� (��ά��ǽ)
NullPointerException - ���ꤵ�줿���Ǥ� null �Ǥ��ꡢ���Υꥹ�Ȥ� null ���Ǥ���Ĥ��ʤ���� (��ά��ǽ)

lastIndexOf

int lastIndexOf(Object o)
���ꤵ�줿���Ǥ��ꥹ����ǺǸ�˸��Ф��줿���֤Υ���ǥå������֤��ޤ��� ���ꤵ�줿���Ǥ��ꥹ�Ȥˤʤ����� -1 ���֤��ޤ����Ĥޤꡢ(o==null ? get(i)==null : o.equals(get(i))) �Ȥʤ롢����Υ���ǥå��� i ���֤��ޤ������Τ褦�ʥ���ǥå�����¸�ߤ��ʤ����� -1 ���֤��ޤ���

�ѥ�᡼��:
o - ������������
�����:
���ꤵ�줿���Ǥ��ꥹ����ǺǸ�˸��Ф��줿���֤Υ���ǥå������������Ǥ��ꥹ�Ȥˤʤ����� -1
�㳰:
ClassCastException - ���ꤵ�줿���Ǥη��������Υꥹ�Ȥȸߴ��Ǥʤ���� (��ά��ǽ)
NullPointerException - ���ꤵ�줿���Ǥ� null �Ǥ��ꡢ���Υꥹ�Ȥ� null ���Ǥ���Ĥ��ʤ���� (��ά��ǽ)

listIterator

ListIterator<E> listIterator()
���Υꥹ��������Ǥ�Ŭ�ڤʽ���Ƿ����֤���������ꥹ��ȿ���Ҥ��֤��ޤ���

�����:
�ꥹ��������Ǥ�Ŭ�ڤʽ���Ƿ����֤���������ꥹ��ȿ����

listIterator

ListIterator<E> listIterator(int index)
�ꥹ��������Ǥ�Ŭ�ڤʽ���Ƿ����֤��������롢�ꥹ����λ��ꤵ�줿���֤��鳫�Ϥ���ȿ���Ҥ��֤��ޤ������ꤵ�줿����ǥå����ϡ�next �κǽ�θƤӽФ��ˤ�ä��֤����ǽ�����Ǥ򼨤��ޤ���previous �κǽ�θƤӽФ��ϡ����ꤵ�줿����ǥå������� 1 ��������ͤΥ���ǥå�����������Ǥ��֤��ޤ���

�ѥ�᡼��:
index - �ꥹ��ȿ���Ҥ��� (next �᥽�åɸƤӽФ��ˤ�ä�) �֤����ǽ�����ǤΥ���ǥå���
�����:
�ꥹ��������Ǥ�Ŭ�ڤʽ���Ƿ����֤��������롢�ꥹ����λ��ꤵ�줿���֤��鳫�Ϥ���ꥹ��ȿ����
�㳰:
IndexOutOfBoundsException - ����ǥå������ϰϳ��ξ�� (index < 0 || index > size())

subList

List<E> 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)

JavaTM Platform
Standard Ed. 6

�Х������ȵ�ǽ�Υꥯ������
����˾ܤ��� API ��ե���󥹤���ӳ�ȯ�ԥɥ�����ȤˤĤ��Ƥϡ�Java SE ��ȯ���ѥɥ�������򻲾Ȥ��Ƥ�����������ȯ�Ը����ξܺ٤ʲ��⡢��ǰ�γ��ס��Ѹ��������Х��β����������ӥ����ɼ��㤬�ޤޤ�Ƥ��ޤ���

Copyright 2009 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy �⻲�Ȥ��Ƥ���������