copyonwritearraylist.html

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

<PRE>
public <B>CopyOnWriteArrayList</B>()</PRE>
<DL>
<DD>创建一个空列表。
<P>
</DL>
<HR>

<A NAME="CopyOnWriteArrayList(java.util.Collection)"><!-- --></A><H3>
CopyOnWriteArrayList</H3>
<PRE>
public <B>CopyOnWriteArrayList</B>(<A HREF="../Collection.html" title="java.util 中的接口">Collection</A>&lt;? extends <A HREF="CopyOnWriteArrayList.html" title="CopyOnWriteArrayList 中的类型参数">E</A>&gt;&nbsp;c)</PRE>
<DL>
<DD>按照 Collection 的迭代器返回元素的顺序，创建一个包含指定 Collection 的元素的列表。
<P>
<DL>
<DT><B>参数：</B><DD><CODE>c</CODE> - 最初保持元素的 collection</DL>
</DL>
<HR>

<A NAME="CopyOnWriteArrayList(java.lang.Object)"><!-- --></A><A NAME="CopyOnWriteArrayList(E[])"><!-- --></A><H3>
CopyOnWriteArrayList</H3>
<PRE>
public <B>CopyOnWriteArrayList</B>(<A HREF="CopyOnWriteArrayList.html" title="CopyOnWriteArrayList 中的类型参数">E</A>[]&nbsp;toCopyIn)</PRE>
<DL>
<DD>创建一个新的 CopyOnWriteArrayList，它保持给定数组的副本。
<P>
<DL>
<DT><B>参数：</B><DD><CODE>toCopyIn</CODE> - 数组（将此数组的副本用作内部数组）</DL>
</DL>

<!-- ============ METHOD DETAIL ========== -->

<A NAME="method_detail"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TH ALIGN="left" COLSPAN="1"><FONT SIZE="+2">
<B>方法详细信息</B></FONT></TH>
</TR>
</TABLE>

<A NAME="size()"><!-- --></A><H3>
size</H3>
<PRE>
public int <B>size</B>()</PRE>
<DL>
<DD>返回此列表中的元素数。
<P>
<DD><DL>
<DT><B>指定者：</B><DD>接口 <CODE><A HREF="../Collection.html" title="java.util 中的接口">Collection</A>&lt;<A HREF="CopyOnWriteArrayList.html" title="CopyOnWriteArrayList 中的类型参数">E</A>&gt;</CODE> 中的 <CODE><A HREF="../Collection.html#size()">size</A></CODE><DT><B>指定者：</B><DD>接口 <CODE><A HREF="../List.html" title="java.util 中的接口">List</A>&lt;<A HREF="CopyOnWriteArrayList.html" title="CopyOnWriteArrayList 中的类型参数">E</A>&gt;</CODE> 中的 <CODE><A HREF="../List.html#size()">size</A></CODE></DL>
</DD>
<DD><DL>

<DT><B>返回：</B><DD>此列表中的元素数。</DL>
</DD>
</DL>
<HR>

<A NAME="isEmpty()"><!-- --></A><H3>
isEmpty</H3>
<PRE>
public boolean <B>isEmpty</B>()</PRE>
<DL>
<DD>测试此列表是否没有任何元素。
<P>
<DD><DL>
<DT><B>指定者：</B><DD>接口 <CODE><A HREF="../Collection.html" title="java.util 中的接口">Collection</A>&lt;<A HREF="CopyOnWriteArrayList.html" title="CopyOnWriteArrayList 中的类型参数">E</A>&gt;</CODE> 中的 <CODE><A HREF="../Collection.html#isEmpty()">isEmpty</A></CODE><DT><B>指定者：</B><DD>接口 <CODE><A HREF="../List.html" title="java.util 中的接口">List</A>&lt;<A HREF="CopyOnWriteArrayList.html" title="CopyOnWriteArrayList 中的类型参数">E</A>&gt;</CODE> 中的 <CODE><A HREF="../List.html#isEmpty()">isEmpty</A></CODE></DL>
</DD>
<DD><DL>

<DT><B>返回：</B><DD>如果此列表没有任何元素，则返回 <tt>true</tt>；否则返回 <tt>false</tt>。</DL>
</DD>
</DL>
<HR>

<A NAME="contains(java.lang.Object)"><!-- --></A><H3>
contains</H3>
<PRE>
public boolean <B>contains</B>(<A HREF="../../lang/Object.html" title="java.lang 中的类">Object</A>&nbsp;elem)</PRE>
<DL>
<DD>如果此列表包含指定的元素，则返回 <tt>true</tt>。
<P>
<DD><DL>
<DT><B>指定者：</B><DD>接口 <CODE><A HREF="../Collection.html" title="java.util 中的接口">Collection</A>&lt;<A HREF="CopyOnWriteArrayList.html" title="CopyOnWriteArrayList 中的类型参数">E</A>&gt;</CODE> 中的 <CODE><A HREF="../Collection.html#contains(java.lang.Object)">contains</A></CODE><DT><B>指定者：</B><DD>接口 <CODE><A HREF="../List.html" title="java.util 中的接口">List</A>&lt;<A HREF="CopyOnWriteArrayList.html" title="CopyOnWriteArrayList 中的类型参数">E</A>&gt;</CODE> 中的 <CODE><A HREF="../List.html#contains(java.lang.Object)">contains</A></CODE></DL>
</DD>
<DD><DL>
<DT><B>参数：</B><DD><CODE>elem</CODE> - 测试该元素是否在此列表中存在。
<DT><B>返回：</B><DD>如果指定的元素存在，则返回 <code>true</code>；否则返回 <code>false</code>。</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;elem)</PRE>
<DL>
<DD>搜索第一次出现的给定参数，用 <tt>equals</tt> 方法进行相等性测试。
<P>
<DD><DL>
<DT><B>指定者：</B><DD>接口 <CODE><A HREF="../List.html" title="java.util 中的接口">List</A>&lt;<A HREF="CopyOnWriteArrayList.html" title="CopyOnWriteArrayList 中的类型参数">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>elem</CODE> - 一个对象。
<DT><B>返回：</B><DD>列表中第一次出现该参数的位置索引；如果未找到对象，则返回 <tt>-1</tt>。<DT><B>另请参见：</B><DD><A HREF="../../lang/Object.html#equals(java.lang.Object)"><CODE>Object.equals(Object)</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="indexOf(java.lang.Object,int)"><!-- --></A><A NAME="indexOf(E, int)"><!-- --></A><H3>
indexOf</H3>
<PRE>
public int <B>indexOf</B>(<A HREF="CopyOnWriteArrayList.html" title="CopyOnWriteArrayList 中的类型参数">E</A>&nbsp;elem,
                   int&nbsp;index)</PRE>
<DL>
<DD>从 <tt>index</tt> 处开始，搜索第一次出现的给定参数，用 <tt>equals</tt> 方法进行相等性测试。
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>参数：</B><DD><CODE>elem</CODE> - 一个对象。<DD><CODE>index</CODE> - 搜索起始处的索引。
<DT><B>返回：</B><DD>在列表中的 <tt>index</tt> 处或其后的位置上，第一次出现该对象参数的位置索引；如果未找到对象，则返回 <tt>-1</tt>。<DT><B>另请参见：</B><DD><A HREF="../../lang/Object.html#equals(java.lang.Object)"><CODE>Object.equals(Object)</CODE></A></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;elem)</PRE>
<DL>
<DD>返回指定的对象在列表中最后一次出现的位置索引。
<P>
<DD><DL>
<DT><B>指定者：</B><DD>接口 <CODE><A HREF="../List.html" title="java.util 中的接口">List</A>&lt;<A HREF="CopyOnWriteArrayList.html" title="CopyOnWriteArrayList 中的类型参数">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>elem</CODE> - 所需的元素。
<DT><B>返回：</B><DD>此列表中最后一次出现指定对象的位置索引；如果未找到对象，则返回 -1。</DL>
</DD>
</DL>
<HR>

<A NAME="lastIndexOf(java.lang.Object,int)"><!-- --></A><A NAME="lastIndexOf(E, int)"><!-- --></A><H3>
lastIndexOf</H3>
<PRE>
public int <B>lastIndexOf</B>(<A HREF="CopyOnWriteArrayList.html" title="CopyOnWriteArrayList 中的类型参数">E</A>&nbsp;elem,
                       int&nbsp;index)</PRE>
<DL>
<DD>从指定索引处开始向后搜索指定的对象，并返回其索引。
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>参数：</B><DD><CODE>elem</CODE> - 所需的元素。<DD><CODE>index</CODE> - 搜索起始处的索引。
<DT><B>返回：</B><DD>在列表中小于 index 的位置上，最后一次出现指定对象的位置索引；如果未找到该对象，则返回 -1。</DL>
</DD>
</DL>
<HR>

<A NAME="clone()"><!-- --></A><H3>
clone</H3>
<PRE>
public <A HREF="../../lang/Object.html" title="java.lang 中的类">Object</A> <B>clone</B>()</PRE>
<DL>
<DD>返回此列表的浅表复制。（这些元素本身未被复制。）
<P>
<DD><DL>
<DT><B>覆盖：</B><DD>类 <CODE><A HREF="../../lang/Object.html" title="java.lang 中的类">Object</A></CODE> 中的 <CODE><A HREF="../../lang/Object.html#clone()">clone</A></CODE></DL>
</DD>
<DD><DL>

<DT><B>返回：</B><DD>此列表的一个克隆。<DT><B>另请参见：</B><DD><A HREF="../../lang/Cloneable.html" title="java.lang 中的接口"><CODE>Cloneable</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="toArray()"><!-- --></A><H3>
toArray</H3>
<PRE>
public <A HREF="../../lang/Object.html" title="java.lang 中的类">Object</A>[] <B>toArray</B>()</PRE>
<DL>
<DD>返回一个按照正确的顺序包含此列表中所有元素的数组。
<P>
<DD><DL>
<DT><B>指定者：</B><DD>接口 <CODE><A HREF="../Collection.html" title="java.util 中的接口">Collection</A>&lt;<A HREF="CopyOnWriteArrayList.html" title="CopyOnWriteArrayList 中的类型参数">E</A>&gt;</CODE> 中的 <CODE><A HREF="../Collection.html#toArray()">toArray</A></CODE><DT><B>指定者：</B><DD>接口 <CODE><A HREF="../List.html" title="java.util 中的接口">List</A>&lt;<A HREF="CopyOnWriteArrayList.html" title="CopyOnWriteArrayList 中的类型参数">E</A>&gt;</CODE> 中的 <CODE><A HREF="../List.html#toArray()">toArray</A></CODE></DL>
</DD>
<DD><DL>

<DT><B>返回：</B><DD>返回一个按照正确的顺序包含此列表所有元素的数组。<DT><B>另请参见：</B><DD><A HREF="../Arrays.html#asList(T...)"><CODE>Arrays.asList(Object[])</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="toArray(java.lang.Object)"><!-- --></A><A NAME="toArray(T[])"><!-- --></A><H3>
toArray</H3>
<PRE>
public &lt;T&gt; T[] <B>toArray</B>(T[]&nbsp;a)</PRE>
<DL>
<DD>返回一个按照正确的顺序包含此列表所有元素的数组。返回数组的运行时类型就是指定数组的运行时类型。如果指定的数组能容纳该列表，则将它返回到该数组。否则，根据指定数组的运行时类型和此列表的大小分配一个新的数组。
 <p>
如果指定的数组能容纳该列表，而且还有剩余空间（即数组的元素比列表多），则将数组中紧随 collection 尾部的元素设置为 null。这在确定列表的长度时很有用，但<em>仅</em> 在调用方知道列表不包含任何 null 元素时才可行。
<P>
<DD><DL>
<DT><B>指定者：</B><DD>接口 <CODE><A HREF="../Collection.html" title="java.util 中的接口">Collection</A>&lt;<A HREF="CopyOnWriteArrayList.html" title="CopyOnWriteArrayList 中的类型参数">E</A>&gt;</CODE> 中的 <CODE><A HREF="../Collection.html#toArray(T[])">toArray</A></CODE><DT><B>指定者：</B><DD>接口 <CODE><A HREF="../List.html" title="java.util 中的接口">List</A>&lt;<A HREF="CopyOnWriteArrayList.html" title="CopyOnWriteArrayList 中的类型参数">E</A>&gt;</CODE> 中的 <CODE><A HREF="../List.html#toArray(T[])">toArray</A></CODE></DL>
</DD>
<DD><DL>
<DT><B>参数：</B><DD><CODE>a</CODE> - 要存储列表元素的数组（如果其足够大）；否则，将分配一个具有相同运行时类型的新数组。
<DT><B>返回：</B><DD>包含该列表元素的数组。
<DT><B>抛出：</B>
<DD><CODE><A HREF="../../lang/ArrayStoreException.html" title="java.lang 中的类">ArrayStoreException</A></CODE> - a 的运行时类型不是此列表中每个元素的运行时类型的超类型。</DL>
</DD>
</DL>
<HR>

<A NAME="get(int)"><!-- --></A><H3>
get</H3>
<PRE>
public <A HREF="CopyOnWriteArrayList.html" title="CopyOnWriteArrayList 中的类型参数">E</A> <B>get</B>(int&nbsp;index)</PRE>
<DL>