abstractlist.html

来自「j2se5-api-zh,java文档的中文版本」· HTML 代码 · 共 825 行 · 第 1/4 页

<DD><CODE><A HREF="../lang/UnsupportedOperationException.html" title="java.lang 中的类">UnsupportedOperationException</A></CODE> - 如果此 Set 不支持 <tt>add</tt> 方法。
<DD><CODE><A HREF="../lang/ClassCastException.html" title="java.lang 中的类">ClassCastException</A></CODE> - 如果指定元素的类不允许该元素添加到此 set 中。
<DD><CODE><A HREF="../lang/IllegalArgumentException.html" title="java.lang 中的类">IllegalArgumentException</A></CODE> - 此元素的某方面不允许它添加到此 collection 中。</DL>
</DD>
</DL>
<HR>

<A NAME="get(int)"><!-- --></A><H3>
get</H3>
<PRE>
public abstract <A HREF="AbstractList.html" title="AbstractList 中的类型参数">E</A> <B>get</B>(int&nbsp;index)</PRE>
<DL>
<DD>返回此列表中指定位置处的元素。
<P>
<DD><DL>
<DT><B>指定者：</B><DD>接口 <CODE><A HREF="List.html" title="java.util 中的接口">List</A>&lt;<A HREF="AbstractList.html" title="AbstractList 中的类型参数">E</A>&gt;</CODE> 中的 <CODE><A HREF="List.html#get(int)">get</A></CODE></DL>
</DD>
<DD><DL>
<DT><B>参数：</B><DD><CODE>index</CODE> - 要返回的元素的索引。
<DT><B>返回：</B><DD>列表中指定位置的元素。
<DT><B>抛出：</B>
<DD><CODE><A HREF="../lang/IndexOutOfBoundsException.html" title="java.lang 中的类">IndexOutOfBoundsException</A></CODE> - 如果给定的索引超出范围 (<tt>index &lt; 0 || index &gt;= size()</tt>)。</DL>
</DD>
</DL>
<HR>

<A NAME="set(int,java.lang.Object)"><!-- --></A><A NAME="set(int, E)"><!-- --></A><H3>
set</H3>
<PRE>
public <A HREF="AbstractList.html" title="AbstractList 中的类型参数">E</A> <B>set</B>(int&nbsp;index,
             <A HREF="AbstractList.html" title="AbstractList 中的类型参数">E</A>&nbsp;element)</PRE>
<DL>
<DD>将此列表中指定位置的元素替换为指定的元素（可选操作）。<p>

此实现始终抛出 <tt>UnsupportedOperationException</tt>。
<P>
<DD><DL>
<DT><B>指定者：</B><DD>接口 <CODE><A HREF="List.html" title="java.util 中的接口">List</A>&lt;<A HREF="AbstractList.html" title="AbstractList 中的类型参数">E</A>&gt;</CODE> 中的 <CODE><A HREF="List.html#set(int, E)">set</A></CODE></DL>
</DD>
<DD><DL>
<DT><B>参数：</B><DD><CODE>index</CODE> - 要替换的元素的索引。<DD><CODE>element</CODE> - 要存储在指定位置的元素。
<DT><B>返回：</B><DD>以前在指定位置处的元素。
<DT><B>抛出：</B>
<DD><CODE><A HREF="../lang/UnsupportedOperationException.html" title="java.lang 中的类">UnsupportedOperationException</A></CODE> - 如果此 List 不支持 <tt>set</tt> 方法。
<DD><CODE><A HREF="../lang/ClassCastException.html" title="java.lang 中的类">ClassCastException</A></CODE> - 如果指定元素的类不允许该元素添加到此列表。
<DD><CODE><A HREF="../lang/IllegalArgumentException.html" title="java.lang 中的类">IllegalArgumentException</A></CODE> - 如果指定元素的某方面不允许它添加到此列表。
<DD><CODE><A HREF="../lang/IndexOutOfBoundsException.html" title="java.lang 中的类">IndexOutOfBoundsException</A></CODE> - 如果指定的索引超出范围 (<tt>index &lt; 0 || index &gt;= size()</tt>)。</DL>
</DD>
</DL>
<HR>

<A NAME="add(int,java.lang.Object)"><!-- --></A><A NAME="add(int, E)"><!-- --></A><H3>
add</H3>
<PRE>
public void <B>add</B>(int&nbsp;index,
                <A HREF="AbstractList.html" title="AbstractList 中的类型参数">E</A>&nbsp;element)</PRE>
<DL>
<DD>在此列表中指定的位置插入指定的元素（可选操作）。向右移动当前处于该位置的元素（如果有）和所有后续元素（将其索引加 1）。<p>

此实现始终抛出 UnsupportedOperationException。
<P>
<DD><DL>
<DT><B>指定者：</B><DD>接口 <CODE><A HREF="List.html" title="java.util 中的接口">List</A>&lt;<A HREF="AbstractList.html" title="AbstractList 中的类型参数">E</A>&gt;</CODE> 中的 <CODE><A HREF="List.html#add(int, E)">add</A></CODE></DL>
</DD>
<DD><DL>
<DT><B>参数：</B><DD><CODE>index</CODE> - 要插入指定元素的位置索引。<DD><CODE>element</CODE> - 要插入的元素。
<DT><B>抛出：</B>
<DD><CODE><A HREF="../lang/UnsupportedOperationException.html" title="java.lang 中的类">UnsupportedOperationException</A></CODE> - 如果此 List 不支持 <tt>add</tt> 方法。
<DD><CODE><A HREF="../lang/ClassCastException.html" title="java.lang 中的类">ClassCastException</A></CODE> - 如果指定元素的类不允许该元素添加到此列表。
<DD><CODE><A HREF="../lang/IllegalArgumentException.html" title="java.lang 中的类">IllegalArgumentException</A></CODE> - 如果指定元素的某方面不允许它添加到此列表。
<DD><CODE><A HREF="../lang/IndexOutOfBoundsException.html" title="java.lang 中的类">IndexOutOfBoundsException</A></CODE> - 索引超出范围 (<tt>index &lt; 0 || index &gt; size()</tt>)。</DL>
</DD>
</DL>
<HR>

<A NAME="remove(int)"><!-- --></A><H3>
remove</H3>
<PRE>
public <A HREF="AbstractList.html" title="AbstractList 中的类型参数">E</A> <B>remove</B>(int&nbsp;index)</PRE>
<DL>
<DD>移除此列表中指定位置处的元素（可选操作）。向左移动所有后续元素（将其索引减 1）。返回从列表中移除的元素。<p>

此实现始终抛出 <tt>UnsupportedOperationException</tt>。
<P>
<DD><DL>
<DT><B>指定者：</B><DD>接口 <CODE><A HREF="List.html" title="java.util 中的接口">List</A>&lt;<A HREF="AbstractList.html" title="AbstractList 中的类型参数">E</A>&gt;</CODE> 中的 <CODE><A HREF="List.html#remove(int)">remove</A></CODE></DL>
</DD>
<DD><DL>
<DT><B>参数：</B><DD><CODE>index</CODE> - 要移除的元素的索引。
<DT><B>返回：</B><DD>以前在指定位置处的元素。
<DT><B>抛出：</B>
<DD><CODE><A HREF="../lang/UnsupportedOperationException.html" title="java.lang 中的类">UnsupportedOperationException</A></CODE> - 如果此 List 不支持 <tt>remove</tt> 方法。
<DD><CODE><A HREF="../lang/IndexOutOfBoundsException.html" title="java.lang 中的类">IndexOutOfBoundsException</A></CODE> - 如果指定的索引超出范围 (<tt>index &lt; 0 || index &gt;= size()</tt>)。</DL>
</DD>
</DL>
<HR>

<A NAME="indexOf(java.lang.Object)"><!-- --></A><H3>
indexOf</H3>
<PRE>
public int <B>indexOf</B>(<A HREF="../lang/Object.html" title="java.lang 中的类">Object</A>&nbsp;o)</PRE>
<DL>
<DD>返回此列表中首次出现指定元素的索引，如果列表中不包含此元素，则返回 -1。更正式地说，返回满足以下条件的最低索引 <tt>i</tt>：<tt>(o==null ? get(i)==null :o.equals(get(i)))</tt>，如果没有满足此条件的索引，则返回 -1。<p>

此实现首先获取一个列表迭代器（使用 <tt>listIterator()</tt>）。然后它迭代列表，直至找到指定的元素，或者到达列表的末尾。
<P>
<DD><DL>
<DT><B>指定者：</B><DD>接口 <CODE><A HREF="List.html" title="java.util 中的接口">List</A>&lt;<A HREF="AbstractList.html" title="AbstractList 中的类型参数">E</A>&gt;</CODE> 中的 <CODE><A HREF="List.html#indexOf(java.lang.Object)">indexOf</A></CODE></DL>
</DD>
<DD><DL>
<DT><B>参数：</B><DD><CODE>o</CODE> - 要搜索的元素。
<DT><B>返回：</B><DD>此列表中首次出现指定元素的索引，如果列表中不包含此元素，则返回 -1。</DL>
</DD>
</DL>
<HR>

<A NAME="lastIndexOf(java.lang.Object)"><!-- --></A><H3>
lastIndexOf</H3>
<PRE>
public int <B>lastIndexOf</B>(<A HREF="../lang/Object.html" title="java.lang 中的类">Object</A>&nbsp;o)</PRE>
<DL>
<DD>返回此列表中最后出现指定元素的索引，如果列表中不包含此元素，则返回 -1。更正式地说，返回满足以下条件的最高索引 <tt>i</tt>：<tt>(o==null ? get(i)==null :o.equals(get(i)))</tt>，如果没有满足此条件的此索引，则返回 -1。<p>

此实现首先获取一个指向列表末尾的列表迭代器（使用 listIterator(size())）。然后它反向迭代列表，直至找到指定的元素，或者到达列表的开头。
<P>
<DD><DL>
<DT><B>指定者：</B><DD>接口 <CODE><A HREF="List.html" title="java.util 中的接口">List</A>&lt;<A HREF="AbstractList.html" title="AbstractList 中的类型参数">E</A>&gt;</CODE> 中的 <CODE><A HREF="List.html#lastIndexOf(java.lang.Object)">lastIndexOf</A></CODE></DL>
</DD>
<DD><DL>
<DT><B>参数：</B><DD><CODE>o</CODE> - 要搜索的元素。
<DT><B>返回：</B><DD>此列表中最后出现指定元素的索引，如果列表中不包含此元素，则返回 -1。</DL>
</DD>
</DL>
<HR>

<A NAME="clear()"><!-- --></A><H3>
clear</H3>
<PRE>
public void <B>clear</B>()</PRE>
<DL>
<DD>从此 collection 中移除所有元素（可选操作）。此调用返回后，该 collection 将为空（除非它抛出异常）。<p>

此实现调用 <tt>removeRange(0, size())</tt>。<p>

注意，除非重写 <tt>remove(int index)</tt> 或 <tt>removeRange(int fromIndex, int toIndex)</tt>，否则此实现将抛出 <tt>UnsupportedOperationException</tt>。
<P>
<DD><DL>
<DT><B>指定者：</B><DD>接口 <CODE><A HREF="Collection.html" title="java.util 中的接口">Collection</A>&lt;<A HREF="AbstractList.html" title="AbstractList 中的类型参数">E</A>&gt;</CODE> 中的 <CODE><A HREF="Collection.html#clear()">clear</A></CODE><DT><B>指定者：</B><DD>接口 <CODE><A HREF="List.html" title="java.util 中的接口">List</A>&lt;<A HREF="AbstractList.html" title="AbstractList 中的类型参数">E</A>&gt;</CODE> 中的 <CODE><A HREF="List.html#clear()">clear</A></CODE><DT><B>覆盖：</B><DD>类 <CODE><A HREF="AbstractCollection.html" title="java.util 中的类">AbstractCollection</A>&lt;<A HREF="AbstractList.html" title="AbstractList 中的类型参数">E</A>&gt;</CODE> 中的 <CODE><A HREF="AbstractCollection.html#clear()">clear</A></CODE></DL>
</DD>
<DD><DL>

<DT><B>抛出：</B>
<DD><CODE><A HREF="../lang/UnsupportedOperationException.html" title="java.lang 中的类">UnsupportedOperationException</A></CODE> - 如果此 Collection 不支持 <tt>clear</tt> 方法。</DL>
</DD>
</DL>
<HR>

<A NAME="addAll(int, java.util.Collection)"><!-- --></A><H3>
addAll</H3>
<PRE>
public boolean <B>addAll</B>(int&nbsp;index,
                      <A HREF="Collection.html" title="java.util 中的接口">Collection</A>&lt;? extends <A HREF="AbstractList.html" title="AbstractList 中的类型参数">E</A>&gt;&nbsp;c)</PRE>
<DL>
<DD>将指定 collection 中的所有元素插入此列表的指定位置（可选操作）。向右移动当前处于该位置的元素（如果有）和所有后续元素（增加其索引）。新元素将按由指定 collection 的迭代器所返回的顺序出现在列表中。如果在该操作进行过程中修改了指定的 collection，则未指定此操作的行为。（注意，如果指定的 collection 为此列表，而且该列表非空，则会发生此行为。）<p>

此实现获取指定 collection 上的迭代器，且迭代此 collection，并使用 <tt>add(int, Object)</tt> 将迭代器获取的元素插入此列表的适当位置，一次插入一个。为了提高效率，多数实现将重写此方法。<p>

注意，除非重写 <tt>add(int, Object)</tt>，否则此实现将抛出 <tt>UnsupportedOperationException</tt>。
<P>
<DD><DL>
<DT><B>指定者：</B><DD>接口 <CODE><A HREF="List.html" title="java.util 中的接口">List</A>&lt;<A HREF="AbstractList.html" title="AbstractList 中的类型参数">E</A>&gt;</CODE> 中的 <CODE><A HREF="List.html#addAll(int, java.util.Collection)">addAll</A></CODE></DL>
</DD>
<DD><DL>
<DT><B>参数：</B><DD><CODE>index</CODE> - 在其中插入指定 collection 中第一个元素的索引。<DD><CODE>c</CODE> - 要插入此列表的元素。
<DT><B>返回：</B><DD>如果此列表由于此方法的调用而发生改变，则返回 <tt>true</tt>。
<DT><B>抛出：</B>
<DD><CODE><A HREF="../lang/UnsupportedOperationException.html" title="java.lang 中的类">UnsupportedOperationException</A></CODE> - 如果此列表不支持 <tt>addAll</tt> 方法。
<DD><CODE><A HREF="../lang/ClassCastException.html" title="java.lang 中的类">ClassCastException</A></CODE> - 如果指定 collection 的元素的类不允许该元素添加到此 List 中。
<DD><CODE><A HREF="../lang/IllegalArgumentException.html" title="java.lang 中的类">IllegalArgumentException</A></CODE> - 指定 collection 的元素的某方面不允许它添加到此 List 中。
<DD><CODE><A HREF="../lang/IndexOutOfBoundsException.html" title="java.lang 中的类">IndexOutOfBoundsException</A></CODE> - 索引超出范围 (<tt>index &lt; 0 || index &gt; size()</tt>)。
<DD><CODE><A HREF="../lang/NullPointerException.html" title="java.lang 中的类">NullPointerException</A></CODE> - 如果指定的 collection 为 null。</DL>
</DD>
</DL>
<HR>

<A NAME="iterator()"><!-- --></A><H3>
iterator</H3>
<PRE>
public <A HREF="Iterator.html" title="java.util 中的接口">Iterator</A>&lt;<A HREF="AbstractList.html" title="AbstractList 中的类型参数">E</A>&gt; <B>iterator</B>()</PRE>
<DL>
<DD>返回以正确顺序在此列表的元素上进行迭代的迭代器。<p>

此实现返回 iterator 接口的一个直接实现，具体取决于底层 list 的 <tt>size()</tt>、<tt>get(int)</tt> 和 <tt>remove(int)</tt> 方法。<p>

注意，除非重写该列表的 <tt>remove(int)</tt> 方法，否则此方法返回的迭代器将抛出一个 <tt>UnsupportedOperationException</tt> 来响应其 <tt>remove</tt> 方法。<p>

在面临并发修改时，可以使此实现抛出运行时异常，如 (protected) <tt>modCount</tt> 字段规范中的描述。
<P>
<DD><DL>
<DT><B>指定者：</B><DD>接口 <CODE><A HREF="../lang/Iterable.html" title="java.lang 中的接口">Iterable</A>&lt;<A HREF="AbstractList.html" title="AbstractList 中的类型参数">E</A>&gt;</CODE> 中的 <CODE><A HREF="../lang/Iterable.html#iterator()">iterator</A></CODE><DT><B>指定者：</B><DD>接口 <CODE><A HREF="Collection.html" title="java.util 中的接口">Collection</A>&lt;<A HREF="AbstractList.html" title="AbstractList 中的类型参数">E</A>&gt;</CODE> 中的 <CODE><A HREF="Collection.html#iterator()">iterator</A></CODE><DT><B>指定者：</B><DD>接口 <CODE><A HREF="List.html" title="java.util 中的接口">List</A>&lt;<A HREF="AbstractList.html" title="AbstractList 中的类型参数">E</A>&gt;</CODE> 中的 <CODE><A HREF="List.html#iterator()">iterator</A></CODE><DT><B>指定者：</B><DD>类 <CODE><A HREF="AbstractCollection.html" title="java.util 中的类">AbstractCollection</A>&lt;<A HREF="AbstractList.html" title="AbstractList 中的类型参数">E</A>&gt;</CODE> 中的 <CODE><A HREF="AbstractCollection.html#iterator()">iterator</A></CODE></DL>
</DD>
<DD><DL>

<DT><B>返回：</B><DD>以正确顺序在此列表的元素上进行迭代的迭代器。<DT><B>另请参见：</B><DD><A HREF="AbstractList.html#modCount"><CODE>modCount</CODE></A></DL>
</DD>
</DL>
<HR>