arraylist.html

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

public <B>ArrayList</B>(<A HREF="Collection.html" title="java.util 中的接口">Collection</A>&lt;? extends <A HREF="ArrayList.html" title="ArrayList 中的类型参数">E</A>&gt;&nbsp;c)</PRE>
<DL>
<DD>构造一个包含指定 collection 的元素的列表，这些元素是按照该 collection 的迭代器返回它们的顺序排列的。<tt>ArrayList</tt> 实例的初始容量是指定 collection 大小的 110%。
<P>
<DL>
<DT><B>参数：</B><DD><CODE>c</CODE> - 其元素将放置在此列表中的 collection 。
<DT><B>抛出：</B>
<DD><CODE><A HREF="../lang/NullPointerException.html" title="java.lang 中的类">NullPointerException</A></CODE> - 如果指定的 collection 为 null。</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="trimToSize()"><!-- --></A><H3>
trimToSize</H3>
<PRE>
public void <B>trimToSize</B>()</PRE>
<DL>
<DD>将此 <tt>ArrayList</tt> 实例的容量调整为列表的当前大小。应用程序可以使用此操作来最小化 <tt>ArrayList</tt> 实例的存储量。
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
</DL>
</DD>
</DL>
<HR>

<A NAME="ensureCapacity(int)"><!-- --></A><H3>
ensureCapacity</H3>
<PRE>
public void <B>ensureCapacity</B>(int&nbsp;minCapacity)</PRE>
<DL>
<DD>如有必要，增加此 <tt>ArrayList</tt> 实例的容量，以确保它至少能够容纳最小容量参数所指定的元素数。
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>参数：</B><DD><CODE>minCapacity</CODE> - 所需的最小容量。</DL>
</DD>
</DL>
<HR>

<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="ArrayList.html" title="ArrayList 中的类型参数">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="ArrayList.html" title="ArrayList 中的类型参数">E</A>&gt;</CODE> 中的 <CODE><A HREF="List.html#size()">size</A></CODE><DT><B>指定者：</B><DD>类 <CODE><A HREF="AbstractCollection.html" title="java.util 中的类">AbstractCollection</A>&lt;<A HREF="ArrayList.html" title="ArrayList 中的类型参数">E</A>&gt;</CODE> 中的 <CODE><A HREF="AbstractCollection.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="ArrayList.html" title="ArrayList 中的类型参数">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="ArrayList.html" title="ArrayList 中的类型参数">E</A>&gt;</CODE> 中的 <CODE><A HREF="List.html#isEmpty()">isEmpty</A></CODE><DT><B>覆盖：</B><DD>类 <CODE><A HREF="AbstractCollection.html" title="java.util 中的类">AbstractCollection</A>&lt;<A HREF="ArrayList.html" title="ArrayList 中的类型参数">E</A>&gt;</CODE> 中的 <CODE><A HREF="AbstractCollection.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="ArrayList.html" title="ArrayList 中的类型参数">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="ArrayList.html" title="ArrayList 中的类型参数">E</A>&gt;</CODE> 中的 <CODE><A HREF="List.html#contains(java.lang.Object)">contains</A></CODE><DT><B>覆盖：</B><DD>类 <CODE><A HREF="AbstractCollection.html" title="java.util 中的类">AbstractCollection</A>&lt;<A HREF="ArrayList.html" title="ArrayList 中的类型参数">E</A>&gt;</CODE> 中的 <CODE><A HREF="AbstractCollection.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="ArrayList.html" title="ArrayList 中的类型参数">E</A>&gt;</CODE> 中的 <CODE><A HREF="List.html#indexOf(java.lang.Object)">indexOf</A></CODE><DT><B>覆盖：</B><DD>类 <CODE><A HREF="AbstractList.html" title="java.util 中的类">AbstractList</A>&lt;<A HREF="ArrayList.html" title="ArrayList 中的类型参数">E</A>&gt;</CODE> 中的 <CODE><A HREF="AbstractList.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="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="ArrayList.html" title="ArrayList 中的类型参数">E</A>&gt;</CODE> 中的 <CODE><A HREF="List.html#lastIndexOf(java.lang.Object)">lastIndexOf</A></CODE><DT><B>覆盖：</B><DD>类 <CODE><A HREF="AbstractList.html" title="java.util 中的类">AbstractList</A>&lt;<A HREF="ArrayList.html" title="ArrayList 中的类型参数">E</A>&gt;</CODE> 中的 <CODE><A HREF="AbstractList.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="clone()"><!-- --></A><H3>
clone</H3>
<PRE>
public <A HREF="../lang/Object.html" title="java.lang 中的类">Object</A> <B>clone</B>()</PRE>
<DL>
<DD>返回此 <tt>ArrayList</tt> 实例的浅表复制。（不复制这些元素本身。）
<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>此 <tt>ArrayList</tt> 实例的一个克隆。<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="ArrayList.html" title="ArrayList 中的类型参数">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="ArrayList.html" title="ArrayList 中的类型参数">E</A>&gt;</CODE> 中的 <CODE><A HREF="List.html#toArray()">toArray</A></CODE><DT><B>覆盖：</B><DD>类 <CODE><A HREF="AbstractCollection.html" title="java.util 中的类">AbstractCollection</A>&lt;<A HREF="ArrayList.html" title="ArrayList 中的类型参数">E</A>&gt;</CODE> 中的 <CODE><A HREF="AbstractCollection.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>

如果指定的数组能容纳列表并有剩余空间（即数组的元素比列表的多），那么会将数组中紧跟在集合末尾的元素设置为 <tt>null</tt>。这对确定列表的长度很有用，但<i>只</i> 在调用方知道列表中不包含任何 <tt>null</tt> 元素时才有用。
<P>
<DD><DL>
<DT><B>指定者：</B><DD>接口 <CODE><A HREF="Collection.html" title="java.util 中的接口">Collection</A>&lt;<A HREF="ArrayList.html" title="ArrayList 中的类型参数">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="ArrayList.html" title="ArrayList 中的类型参数">E</A>&gt;</CODE> 中的 <CODE><A HREF="List.html#toArray(T[])">toArray</A></CODE><DT><B>覆盖：</B><DD>类 <CODE><A HREF="AbstractCollection.html" title="java.util 中的类">AbstractCollection</A>&lt;<A HREF="ArrayList.html" title="ArrayList 中的类型参数">E</A>&gt;</CODE> 中的 <CODE><A HREF="AbstractCollection.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="ArrayList.html" title="ArrayList 中的类型参数">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="ArrayList.html" title="ArrayList 中的类型参数">E</A>&gt;</CODE> 中的 <CODE><A HREF="List.html#get(int)">get</A></CODE><DT><B>指定者：</B><DD>类 <CODE><A HREF="AbstractList.html" title="java.util 中的类">AbstractList</A>&lt;<A HREF="ArrayList.html" title="ArrayList 中的类型参数">E</A>&gt;</CODE> 中的 <CODE><A HREF="AbstractList.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="ArrayList.html" title="ArrayList 中的类型参数">E</A> <B>set</B>(int&nbsp;index,
             <A HREF="ArrayList.html" title="ArrayList 中的类型参数">E</A>&nbsp;element)</PRE>
<DL>
<DD>用指定的元素替代此列表中指定位置上的元素。
<P>
<DD><DL>