array.html

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

            int&nbsp;length)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;创建一个具有指定的组件类型和长度的新数组。</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>static&nbsp;<A HREF="../Object.html" title="java.lang 中的类">Object</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="Array.html#newInstance(java.lang.Class, int[])">newInstance</A></B>(<A HREF="../Class.html" title="java.lang 中的类">Class</A>&lt;?&gt;&nbsp;componentType,
            int[]&nbsp;dimensions)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;创建一个具有指定的组件类型和维度的新数组。</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>static&nbsp;void</CODE></FONT></TD>
<TD><CODE><B><A HREF="Array.html#set(java.lang.Object, int, java.lang.Object)">set</A></B>(<A HREF="../Object.html" title="java.lang 中的类">Object</A>&nbsp;array,
    int&nbsp;index,
    <A HREF="../Object.html" title="java.lang 中的类">Object</A>&nbsp;value)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;将指定数组对象中索引组件的值设置为指定的新值。</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>static&nbsp;void</CODE></FONT></TD>
<TD><CODE><B><A HREF="Array.html#setBoolean(java.lang.Object, int, boolean)">setBoolean</A></B>(<A HREF="../Object.html" title="java.lang 中的类">Object</A>&nbsp;array,
           int&nbsp;index,
           boolean&nbsp;z)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;将指定数组对象中索引组件的值设置为指定的 <code>boolean</code> 值。</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>static&nbsp;void</CODE></FONT></TD>
<TD><CODE><B><A HREF="Array.html#setByte(java.lang.Object, int, byte)">setByte</A></B>(<A HREF="../Object.html" title="java.lang 中的类">Object</A>&nbsp;array,
        int&nbsp;index,
        byte&nbsp;b)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;将指定数组对象中索引组件的值设置为指定的 <code>byte</code> 值。</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>static&nbsp;void</CODE></FONT></TD>
<TD><CODE><B><A HREF="Array.html#setChar(java.lang.Object, int, char)">setChar</A></B>(<A HREF="../Object.html" title="java.lang 中的类">Object</A>&nbsp;array,
        int&nbsp;index,
        char&nbsp;c)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;将指定数组对象中索引组件的值设置为指定的 <code>char</code> 值。</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>static&nbsp;void</CODE></FONT></TD>
<TD><CODE><B><A HREF="Array.html#setDouble(java.lang.Object, int, double)">setDouble</A></B>(<A HREF="../Object.html" title="java.lang 中的类">Object</A>&nbsp;array,
          int&nbsp;index,
          double&nbsp;d)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;将指定数组对象中索引组件的值设置为指定的 <code>double</code> 值。</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>static&nbsp;void</CODE></FONT></TD>
<TD><CODE><B><A HREF="Array.html#setFloat(java.lang.Object, int, float)">setFloat</A></B>(<A HREF="../Object.html" title="java.lang 中的类">Object</A>&nbsp;array,
         int&nbsp;index,
         float&nbsp;f)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;将指定数组对象中索引组件的值设置为指定的 <code>float</code> 值。</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>static&nbsp;void</CODE></FONT></TD>
<TD><CODE><B><A HREF="Array.html#setInt(java.lang.Object, int, int)">setInt</A></B>(<A HREF="../Object.html" title="java.lang 中的类">Object</A>&nbsp;array,
       int&nbsp;index,
       int&nbsp;i)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;将指定数组对象中索引组件的值设置为指定的 <code>int</code> 值。</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>static&nbsp;void</CODE></FONT></TD>
<TD><CODE><B><A HREF="Array.html#setLong(java.lang.Object, int, long)">setLong</A></B>(<A HREF="../Object.html" title="java.lang 中的类">Object</A>&nbsp;array,
        int&nbsp;index,
        long&nbsp;l)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;将指定数组对象中索引组件的值设置为指定的 <code>long</code> 值。</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>static&nbsp;void</CODE></FONT></TD>
<TD><CODE><B><A HREF="Array.html#setShort(java.lang.Object, int, short)">setShort</A></B>(<A HREF="../Object.html" title="java.lang 中的类">Object</A>&nbsp;array,
         int&nbsp;index,
         short&nbsp;s)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;将指定数组对象中索引组件的值设置为指定的 <code>short</code> 值。</TD>
</TR>
</TABLE>
&nbsp;<A NAME="methods_inherited_from_class_java.lang.Object"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
<TH ALIGN="left"><B>从类 java.lang.<A HREF="../Object.html" title="java.lang 中的类">Object</A> 继承的方法</B></TH>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD><CODE><A HREF="../Object.html#clone()">clone</A>, <A HREF="../Object.html#equals(java.lang.Object)">equals</A>, <A HREF="../Object.html#finalize()">finalize</A>, <A HREF="../Object.html#getClass()">getClass</A>, <A HREF="../Object.html#hashCode()">hashCode</A>, <A HREF="../Object.html#notify()">notify</A>, <A HREF="../Object.html#notifyAll()">notifyAll</A>, <A HREF="../Object.html#toString()">toString</A>, <A HREF="../Object.html#wait()">wait</A>, <A HREF="../Object.html#wait(long)">wait</A>, <A HREF="../Object.html#wait(long, int)">wait</A></CODE></TD>
</TR>
</TABLE>
&nbsp;
<P>

<!-- ============ 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="newInstance(java.lang.Class, int)"><!-- --></A><H3>
newInstance</H3>
<PRE>
public static <A HREF="../Object.html" title="java.lang 中的类">Object</A> <B>newInstance</B>(<A HREF="../Class.html" title="java.lang 中的类">Class</A>&lt;?&gt;&nbsp;componentType,
                                 int&nbsp;length)
                          throws <A HREF="../NegativeArraySizeException.html" title="java.lang 中的类">NegativeArraySizeException</A></PRE>
<DL>
<DD>创建一个具有指定的组件类型和长度的新数组。调用此方法等效于创建如下数组：
 <blockquote>
 <pre>
 int[] x = {length};
 Array.newInstance(componentType, x);
 </pre>
 </blockquote>
<P>
<DD><DL>
<DT><B>参数：</B><DD><CODE>componentType</CODE> - 表示新数组的组件类型的 <code>Class</code> 对象<DD><CODE>length</CODE> - 新数组的长度
<DT><B>返回：</B><DD>新数组
<DT><B>抛出：</B>
<DD><CODE><A HREF="../NullPointerException.html" title="java.lang 中的类">NullPointerException</A></CODE> - 如果指定的 <code>componentType</code> 参数为 null
<DD><CODE><A HREF="../IllegalArgumentException.html" title="java.lang 中的类">IllegalArgumentException</A></CODE> - 如果 componentType 为 Void.TYPE
<DD><CODE><A HREF="../NegativeArraySizeException.html" title="java.lang 中的类">NegativeArraySizeException</A></CODE> - 如果指定的 <code>length</code> 为负</DL>
</DD>
</DL>
<HR>

<A NAME="newInstance(java.lang.Class, int[])"><!-- --></A><H3>
newInstance</H3>
<PRE>
public static <A HREF="../Object.html" title="java.lang 中的类">Object</A> <B>newInstance</B>(<A HREF="../Class.html" title="java.lang 中的类">Class</A>&lt;?&gt;&nbsp;componentType,
                                 int[]&nbsp;dimensions)
                          throws <A HREF="../IllegalArgumentException.html" title="java.lang 中的类">IllegalArgumentException</A>,
                                 <A HREF="../NegativeArraySizeException.html" title="java.lang 中的类">NegativeArraySizeException</A></PRE>
<DL>
<DD>创建一个具有指定的组件类型和维度的新数组。如果 <code>componentType</code> 表示一个非数组类或接口，则新数组具有 <code>dimensions.length</code> 维度，并且将 <code>componentType</code> 作为其组件类型。如果 <code>componentType</code> 表示一个数组类，则新数组的维数等于 <code>dimensions.length</code> 和 <code>componentType</code> 的维数的总和。在这种情况下，新数组的组件类型为 <code>componentType</code> 的组件类型。
 
<p>新数组的维数不能超过该实现所支持的数组维数（通常为 255）。
<P>
<DD><DL>
<DT><B>参数：</B><DD><CODE>componentType</CODE> - 表示新数组的组件类型的 <code>Class</code> 对象<DD><CODE>dimensions</CODE> - 表示新数组维度的 <code>int</code> 类型的数组
<DT><B>返回：</B><DD>新数组
<DT><B>抛出：</B>
<DD><CODE><A HREF="../NullPointerException.html" title="java.lang 中的类">NullPointerException</A></CODE> - 如果指定的 <code>componentType</code> 参数为 null
<DD><CODE><A HREF="../IllegalArgumentException.html" title="java.lang 中的类">IllegalArgumentException</A></CODE> - 如果指定的 <code>dimensions</code> 参数是一个零维度的数组，或者如果所请求的维数超过了该实现所支持的数组维数的限制（通常为 225），或者度的数组，或者如果所请求的维数超过了该实现所支持的数组维数的限制（通常为 225），或者 componentType 为 Void.TYPE。
<DD><CODE><A HREF="../NegativeArraySizeException.html" title="java.lang 中的类">NegativeArraySizeException</A></CODE> - 如果指定的 <code>dimensions</code> 参数中的任意组件为负。</DL>
</DD>
</DL>
<HR>

<A NAME="getLength(java.lang.Object)"><!-- --></A><H3>
getLength</H3>
<PRE>
public static int <B>getLength</B>(<A HREF="../Object.html" title="java.lang 中的类">Object</A>&nbsp;array)
                     throws <A HREF="../IllegalArgumentException.html" title="java.lang 中的类">IllegalArgumentException</A></PRE>
<DL>
<DD>以 <code>int</code> 形式返回指定数组对象的长度。
<P>
<DD><DL>
<DT><B>参数：</B><DD><CODE>array</CODE> - 数组
<DT><B>返回：</B><DD>数组的长度
<DT><B>抛出：</B>
<DD><CODE><A HREF="../IllegalArgumentException.html" title="java.lang 中的类">IllegalArgumentException</A></CODE> - 如果对象参数不是一个数组</DL>
</DD>
</DL>
<HR>

<A NAME="get(java.lang.Object, int)"><!-- --></A><H3>
get</H3>
<PRE>
public static <A HREF="../Object.html" title="java.lang 中的类">Object</A> <B>get</B>(<A HREF="../Object.html" title="java.lang 中的类">Object</A>&nbsp;array,
                         int&nbsp;index)
                  throws <A HREF="../IllegalArgumentException.html" title="java.lang 中的类">IllegalArgumentException</A>,
                         <A HREF="../ArrayIndexOutOfBoundsException.html" title="java.lang 中的类">ArrayIndexOutOfBoundsException</A></PRE>
<DL>
<DD>返回指定数组对象中索引组件的值。如果该值是一个基本类型值，则自动将其包装在一个对象中。
<P>
<DD><DL>
<DT><B>参数：</B><DD><CODE>array</CODE> - 数组<DD><CODE>index</CODE> - 索引
<DT><B>返回：</B><DD>指定数组中索引组件的（可能已封装的）值
<DT><B>抛出：</B>
<DD><CODE><A HREF="../NullPointerException.html" title="java.lang 中的类">NullPointerException</A></CODE> - 如果指定对象为 null
<DD><CODE><A HREF="../IllegalArgumentException.html" title="java.lang 中的类">IllegalArgumentException</A></CODE> - 如果指定对象不是一个数组
<DD><CODE><A HREF="../ArrayIndexOutOfBoundsException.html" title="java.lang 中的类">ArrayIndexOutOfBoundsException</A></CODE> - 如果指定的 <code>index</code> 参数为负，或者如果它大于或等于指定数组的长度</DL>
</DD>
</DL>