string.html

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

<A HREF="String.html#String(byte[])"><CODE>String(byte[])</CODE></A></DL>
</DL>
<HR>

<A NAME="String(byte[], int, int, java.lang.String)"><!-- --></A><H3>
String</H3>
<PRE>
public <B>String</B>(byte[]&nbsp;bytes,
              int&nbsp;offset,
              int&nbsp;length,
              <A HREF="String.html" title="java.lang 中的类">String</A>&nbsp;charsetName)
       throws java.io.UnsupportedEncodingException</PRE>
<DL>
<DD>构造一个新的 <tt>String</tt>，方法是使用指定的字符集解码字节的指定子数组。新的 <tt>String</tt> 的长度是一个字符集函数，因此不能等于子数组的长度。

<p> 当给定字节在给定字符集中无效的情况下，该构造方法无指定的行为。当需要进一步控制解码过程时，应使用 <CODE>CharsetDecoder</CODE> 类。
<P>
<DL>
<DT><B>参数：</B><DD><CODE>bytes</CODE> - 要解码为字符的字节<DD><CODE>offset</CODE> - 要解码的首字节的索引<DD><CODE>length</CODE> - 要解码的字节数<DD><CODE>charsetName</CODE> - 受支持的 <CODE></code>charset<code></CODE> 的名称
<DT><B>抛出：</B>
<DD><CODE>java.io.UnsupportedEncodingException</CODE> - 如果指定的字符集不受支持
<DD><CODE><A HREF="IndexOutOfBoundsException.html" title="java.lang 中的类">IndexOutOfBoundsException</A></CODE> - 如果 <tt>offset</tt> 和 <tt>length</tt> 参数索引字符超出 <tt>bytes</tt> 数组的范围<DT><B>从以下版本开始：</B></DT>
  <DD>JDK1.1</DD>
</DL>
</DL>
<HR>

<A NAME="String(byte[], java.lang.String)"><!-- --></A><H3>
String</H3>
<PRE>
public <B>String</B>(byte[]&nbsp;bytes,
              <A HREF="String.html" title="java.lang 中的类">String</A>&nbsp;charsetName)
       throws java.io.UnsupportedEncodingException</PRE>
<DL>
<DD>构造一个新的 <tt>String</tt>，方法是使用指定的字符集解码指定的字节数组。新的 <tt>String</tt> 的长度是一个字符集函数，因此不能等于字节数组的长度。

<p> 当给定字节在给定字符集中无效的情况下，该构造方法无指定的行为。当需要进一步控制解码过程时，应使用 <CODE>CharsetDecoder</CODE> 类。
<P>
<DL>
<DT><B>参数：</B><DD><CODE>bytes</CODE> - 要解码为字符的字节<DD><CODE>charsetName</CODE> - 受支持的 <CODE></code>charset<code></CODE> 的名称
<DT><B>抛出：</B>
<DD><CODE>java.io.UnsupportedEncodingException</CODE> - 如果指定字符集不受支持<DT><B>从以下版本开始：</B></DT>
  <DD>JDK1.1</DD>
</DL>
</DL>
<HR>

<A NAME="String(byte[], int, int)"><!-- --></A><H3>
String</H3>
<PRE>
public <B>String</B>(byte[]&nbsp;bytes,
              int&nbsp;offset,
              int&nbsp;length)</PRE>
<DL>
<DD>构造一个新的 <tt>String</tt>，方法是使用指定的字符集解码字节的指定子数组。新的 <tt>String</tt> 的长度是一个字符集函数，因此不能等于该子数组的长度。

<p> 当给定字节在给定字符集中无效的情况下，该构造方法无指定的行为。当需要进一步控制解码过程时，应使用 <CODE>CharsetDecoder</CODE> 类。
<P>
<DL>
<DT><B>参数：</B><DD><CODE>bytes</CODE> - 要解码为字符的字节<DD><CODE>offset</CODE> - 要解码的首字节的索引<DD><CODE>length</CODE> - 要解码的字节数
<DT><B>抛出：</B>
<DD><CODE><A HREF="IndexOutOfBoundsException.html" title="java.lang 中的类">IndexOutOfBoundsException</A></CODE> - 如果 <code>offset</code> 和 <code>length</code> 参数索引字符超出 <code>bytes</code> 数组的范围<DT><B>从以下版本开始：</B></DT>
  <DD>JDK1.1</DD>
</DL>
</DL>
<HR>

<A NAME="String(byte[])"><!-- --></A><H3>
String</H3>
<PRE>
public <B>String</B>(byte[]&nbsp;bytes)</PRE>
<DL>
<DD>构造一个新的 <tt>String</tt>，方法是使用平台的默认字符集解码字节的指定数组。新的 <tt>String</tt> 的长度是一个字符集函数，因此不能等于字节数组的长度。

<p> 当给定字节在给定字符集中无效的情况下，该构造方法无指定的行为。当需要进一步控制解码过程时，应使用 <CODE>CharsetDecoder</CODE> 类。
<P>
<DL>
<DT><B>参数：</B><DD><CODE>bytes</CODE> - 要解码为字符的字节<DT><B>从以下版本开始：</B></DT>
  <DD>JDK1.1</DD>
</DL>
</DL>
<HR>

<A NAME="String(java.lang.StringBuffer)"><!-- --></A><H3>
String</H3>
<PRE>
public <B>String</B>(<A HREF="StringBuffer.html" title="java.lang 中的类">StringBuffer</A>&nbsp;buffer)</PRE>
<DL>
<DD>分配一个新的字符串，它包含当前包含在字符串缓冲区参数中的字符序列。此字符串缓冲区的内容已被复制，后续对它的修改不会影响新创建的字符串。
<P>
<DL>
<DT><B>参数：</B><DD><CODE>buffer</CODE> - 一个 <code>StringBuffer</code>。</DL>
</DL>
<HR>

<A NAME="String(java.lang.StringBuilder)"><!-- --></A><H3>
String</H3>
<PRE>
public <B>String</B>(<A HREF="StringBuilder.html" title="java.lang 中的类">StringBuilder</A>&nbsp;builder)</PRE>
<DL>
<DD>分配一个新的字符串，它包含当前包含在字符串生成器参数中的字符序列。此字符串生成器的内容已被复制，后续对此字符串生成器的修改不会影响新创建的字符串。

<p>提供该构造方法以简化到 <code>StringBuilder</code> 的迁移。通过 <code>toString</code> 方法从字符串生成器中获得字符串可能是一种更快的方法，因此通常作为首选。
<P>
<DL>
<DT><B>参数：</B><DD><CODE>builder</CODE> - 一个 <code>StringBuilder</code><DT><B>从以下版本开始：</B></DT>
  <DD>1.5</DD>
</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="length()"><!-- --></A><H3>
length</H3>
<PRE>
public int <B>length</B>()</PRE>
<DL>
<DD>返回此字符串的长度。长度等于字符串中 16 位 Unicode 字符数。
<P>
<DD><DL>
<DT><B>指定者：</B><DD>接口 <CODE><A HREF="CharSequence.html" title="java.lang 中的接口">CharSequence</A></CODE> 中的 <CODE><A HREF="CharSequence.html#length()">length</A></CODE></DL>
</DD>
<DD><DL>

<DT><B>返回：</B><DD>此对象表示的字符序列的长度。</DL>
</DD>
</DL>
<HR>

<A NAME="charAt(int)"><!-- --></A><H3>
charAt</H3>
<PRE>
public char <B>charAt</B>(int&nbsp;index)</PRE>
<DL>
<DD>返回指定索引处的 <code>char</code> 值。索引范围为从 <code>0</code> 到 <code>length() - 1</code>。序列的第一个 <code>char</code> 值在索引 <code>0</code> 处，第二个在索引 <code>1</code> 处，依此类推，这类似于数组索引。

<p>如果索引指定的 <code>char</code> 值是<a href="Character.html#unicode">代理项</a>，则返回代理项值。
<P>
<DD><DL>
<DT><B>指定者：</B><DD>接口 <CODE><A HREF="CharSequence.html" title="java.lang 中的接口">CharSequence</A></CODE> 中的 <CODE><A HREF="CharSequence.html#charAt(int)">charAt</A></CODE></DL>
</DD>
<DD><DL>
<DT><B>参数：</B><DD><CODE>index</CODE> - <code>char</code> 值的索引。
<DT><B>返回：</B><DD>此字符串指定索引处的 <code>char</code> 值。第一个 <code>char</code> 值在索引 <code>0</code> 处。
<DT><B>抛出：</B>
<DD><CODE><A HREF="IndexOutOfBoundsException.html" title="java.lang 中的类">IndexOutOfBoundsException</A></CODE> - 如果 <code>index</code> 参数为负或小于此字符串的长度。</DL>
</DD>
</DL>
<HR>

<A NAME="codePointAt(int)"><!-- --></A><H3>
codePointAt</H3>
<PRE>
public int <B>codePointAt</B>(int&nbsp;index)</PRE>
<DL>
<DD>返回指定索引处的字符（Unicode 代码点）。该索引引用 <code>char</code> 值（Unicode 代码单元），其范围从 <code>0</code> 到 <A HREF="String.html#length()"><CODE>length()</CODE></A><code> - 1</code>。

<p> 如果给定索引指定的 <code>char</code> 值属于高代理项范围，则后续索引小于此 <code>String</code> 的长度。同样，如果后续索引处的 <code>char</code> 值属于低代理项范围，则返回该代理项对相应的增补代码点。否则，返回给定索引处的 <code>char</code> 值。
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>参数：</B><DD><CODE>index</CODE> - <code>char</code> 值的索引
<DT><B>返回：</B><DD>该 <code>index</code> 处字符的代码点值
<DT><B>抛出：</B>
<DD><CODE><A HREF="IndexOutOfBoundsException.html" title="java.lang 中的类">IndexOutOfBoundsException</A></CODE> - 如果 <code>index</code> 参数为负或小于此字符串的长度。<DT><B>从以下版本开始：</B></DT>
  <DD>1.5</DD>
</DL>
</DD>
</DL>
<HR>

<A NAME="codePointBefore(int)"><!-- --></A><H3>
codePointBefore</H3>
<PRE>
public int <B>codePointBefore</B>(int&nbsp;index)</PRE>
<DL>
<DD>返回指定索引之前的字符（Unicode 代码点）。该索引引用 <code>char</code> 值（Unicode 代码单元），其范围从 <code>1</code> 到 <A HREF="CharSequence.html#length()"><CODE>length</CODE></A>。

<p> 如果 <code>(index - 1)</code> 处的 <code>char</code> 值属于低代理项范围，则 <code>(index - 2)</code> 为非负；如果<code>(index - 2)</code> 处的 <code>char</code> 值属于高低理项范围，则返回该代理项对的增补代码点值。如果 <code>index - 1</code> 处的 <code>char</code> 值是未配对的低（高）代理项，则返回代理项值。
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>参数：</B><DD><CODE>index</CODE> - 应返回的代码点后面的索引
<DT><B>返回：</B><DD>在给定索引前的 Unicode 代码点。
<DT><B>抛出：</B>
<DD><CODE><A HREF="IndexOutOfBoundsException.html" title="java.lang 中的类">IndexOutOfBoundsException</A></CODE> - 如果 <code>index</code> 参数小于 1 或大于此字符串的长度。<DT><B>从以下版本开始：</B></DT>
  <DD>1.5</DD>
</DL>
</DD>
</DL>
<HR>

<A NAME="codePointCount(int, int)"><!-- --></A><H3>
codePointCount</H3>
<PRE>
public int <B>codePointCount</B>(int&nbsp;beginIndex,
                          int&nbsp;endIndex)</PRE>
<DL>
<DD>返回此 <code>String</code> 的指定文本范围中的 Unicode 代码点数。文本范围始于指定的 <code>beginIndex</code>，一直到索引 <code>endIndex - 1</code> 处的 <code>char</code>。因此，该文本范围的长度（在 <code>char</code> 中）是 <code>endIndex-beginIndex</code>。该文本范围内未配对的代理项作为一个代码点计数。
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>参数：</B><DD><CODE>beginIndex</CODE> - 该文本范围的第一个 <code>char</code> 的索引。<DD><CODE>endIndex</CODE> - 该文本范围的最后一个 <code>char</code> 后面的索引。
<DT><B>返回：</B><DD>指定文本范围中 Unicode 代码点的数量
<DT><B>抛出：</B>
<DD><CODE><A HREF="IndexOutOfBoundsException.html" title="java.lang 中的类">IndexOutOfBoundsException</A></CODE> - 如果 <code>beginIndex</code> 为负，或 <code>endIndex</code> 大于此 <code>String</code> 的长度，或 <code>beginIndex</code> 大于 <code>endIndex</code>。<DT><B>从以下版本开始：</B></DT>
  <DD>1.5</DD>
</DL>
</DD>
</DL>
<HR>

<A NAME="offsetByCodePoints(int, int)"><!-- --></A><H3>
offsetByCodePoints</H3>
<PRE>
public int <B>offsetByCodePoints</B>(int&nbsp;index,
                              int&nbsp;codePointOffset)</PRE>
<DL>
<DD>返回此 <code>String</code> 中从给定的 <code>index</code> 处偏移 <code>codePointOffset</code> 个代码点的索引。文本范围内由 <code>index</code> 和 <code>codePointOffset</code> 给定的未配对代理项各计为一个代码点。
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>参数：</B><DD><CODE>index</CODE> - 要偏移的索引<DD><CODE>codePointOffset</CODE> - 代码点中的偏移量
<DT><B>返回：</B><DD><code>String</code> 的索引
<DT><B>抛出：</B>
<DD><CODE><A HREF="IndexOutOfBoundsException.html" title="java.lang 中的类">IndexOutOfBoundsException</A></CODE> - 如果 <code>index</code> 为负或大于此 <code>String</code> 的长度；或者如果 <code>codePointOffset</code> 为正，并且以 <code>index</code> 开头的子字符串比 <code>codePointOffset</code> 具有更少的代码点；或者如果 <code>codePointOffset</code> 为负，并且 <code>index</co