java.lang.CharSequence翻译 - 王朝网络宽屏版

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">

<HTML>

<HEAD>

<TITLE>

CharSequence (Java 2 Platform SE v1.4.2)

</TITLE>

function windowTitle()

{

parent.document.title="CharSequence (Java 2 Platform SE v1.4.2)";

}

</SCRIPT>

</HEAD>

<TR>

<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../overview-summary.html">Overview</A> </TD>

<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-summary.html">Package</A> </TD>

<TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev">  Class </TD>

<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../deprecated-list.html">Deprecated</A> </TD>

<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../index-files/index-1.html">Index</A> </TD>

</TR>

</TABLE>

</TD>

JavaTM 2 Platform Std. Ed. v1.4.2

</TD>

</TR>

<TR>

 PREV CLASS 

<A HREF="../../java/lang/Cloneable.html" title="interface in java.lang">NEXT CLASS</A></TD>

<A HREF="../../index.html" target="_top">FRAMES</A>

<A HREF="CharSequence.html" target="_top">NO FRAMES</A>

<!--

if(window==top) {

document.writeln('<A HREF="../../allclasses-noframe.html">All Classes</A>');

}

//-->

</SCRIPT>

<A HREF="../../allclasses-noframe.html">All Classes</A>

</NOSCRIPT>

</TD>

</TR>

<TR>

SUMMARY: NESTED | FIELD | CONSTR | <A HREF="#method_summary">METHOD</A></TD>

DETAIL: FIELD | CONSTR | <A HREF="#method_detail">METHOD</A></TD>

</TR>

</TABLE>

<HR>

<H2>

java.lang

Interface CharSequence</H2>

<DL>

<DT>All Known Implementing Classes: <DD><A HREF="../../java/nio/CharBuffer.html" title="class in java.nio">CharBuffer</A>, <A HREF="../../java/lang/String.html" title="class in java.lang">String</A>, <A HREF="../../java/lang/StringBuffer.html" title="class in java.lang">StringBuffer</A></DD>

</DL>

<HR>

<DL>

<DT>public interface CharSequence</DL>

A <tt>CharSequence</tt> is a readable sequence of characters. This

interface provides uniform, read-only access to many different kinds of

character sequences.

CharSequence用作只读的字符序列，该接口提供了多种不同字符序列的统一访问方式。

This interface does not refine the general contracts of the <A HREF="../../java/lang/Object.html#equals(java.lang.Object)"><CODE>equals</CODE></A> and <A HREF="../../java/lang/Object.html#hashCode()"><CODE>hashCode</CODE></A> methods. The result of comparing two

objects that implement <tt>CharSequence</tt> is therefore, in general,

undefined. Each object may be implemented by a different class, and there

is no guarantee that each class will be capable of testing its instances

for equality with those of the other. It is therefore inappropriate to use

arbitrary <tt>CharSequence</tt> instances as elements in a set or as keys in

a map.

该接口没有重新定义通用的equals和hashCode方法，因此没有对实现CharSequence的两个对象进行比较的结果给出定义。

每个对象可能由不同的类实现，因此不能随意的对两个对象进行比较，所以将CharSequence的实例

作为set的元素或者map的关键字都是不合适的。

<DL>

<DT>Since:</DT>

</DL>

<HR>

Method Summary</TD>

</TR>

<TD><CODE><A HREF="../../java/lang/CharSequence.html#charAt(int)">charAt</A>(int index)</CODE>

Returns the character at the specified index.返回指定下标的字符。</TD>

</TR>

<TD><CODE><A HREF="../../java/lang/CharSequence.html#length()">length</A>()</CODE>

Returns the length of this character sequence.返回该字符序列的长度。</TD>

</TR>

<CODE> <A HREF="../../java/lang/CharSequence.html" title="interface in java.lang">CharSequence</A></CODE></TD>

<TD><CODE><A HREF="../../java/lang/CharSequence.html#subSequence(int, int)">subSequence</A>(int start,

int end)</CODE>

          Returns a new character sequence that is a subsequence of this sequence.

返回该字符序列的子序列。</TD>

</TR>

<CODE> <A HREF="../../java/lang/String.html" title="class in java.lang">String</A></CODE></TD>

<TD><CODE><A HREF="../../java/lang/CharSequence.html#toString()">toString</A>()</CODE>

          Returns a string containing the characters in this sequence in the same

order as this sequence.

将该字符序列按相同顺序转换成字符串。</TD>

</TR>

</TABLE>

Method Detail</TD>

</TR>

</TABLE>

length</H3>

<PRE>

public int length()</PRE>

<DL>

<DD>Returns the length of this character sequence. The length is the number

of 16-bit Unicode characters in the sequence.

返回字符序列的长度，此长度指的是字符序列中16比特的Unicode字符数。

<DT>Returns:<DD>the number of characters in this sequence

序列中的字符数</DL>

</DD>

</DL>

<HR>

charAt</H3>

<PRE>

public char charAt(int index)</PRE>

<DL>

<DD>Returns the character at the specified index. An index ranges from zero

to <tt>length() - 1</tt>. The first character of the sequence is at

index zero, the next at index one, and so on, as for array

indexing. 返回指定下标处的字符。下标的范围从0到length()-1。第一个字符的下标为0，其次为1，以此类推。

<DT>Parameters:<DD><CODE>index</CODE> - the index of the character to be returned

被返回字符的下标

<DT>Returns:<DD>the specified character 指定字符

<DT>Throws:

<DD><CODE><A HREF="../../java/lang/IndexOutOfBoundsException.html" title="class in java.lang">IndexOutOfBoundsException</A></CODE> - if the <tt>index</tt> argument is negative or not less than

<tt>length()</tt> 如果index参数为负或不小于length时抛出。</DL>

</DD>

</DL>

<HR>

subSequence</H3>

<PRE>

public <A HREF="../../java/lang/CharSequence.html" title="interface in java.lang">CharSequence</A> subSequence(int start,

int end)</PRE>

<DL>

<DD>Returns a new character sequence that is a subsequence of this sequence.

The subsequence starts with the character at the specified index and

ends with the character at index <tt>end - 1</tt>. The length of the

returned sequence is <tt>end - start</tt>, so if <tt>start == end</tt>

then an empty sequence is returned.

返回该字符序列的子序列。子序列由指定下标的字符开始，结束于下标为end-1的字符处。返回的序列长度

为end-start，因此如果start==end，返回空序列。

<DT>Parameters:<DD><CODE>start</CODE> - the start index, inclusive

开始下标，含本下标处的字符<DD><CODE>end</CODE> - the end index, exclusive

结束下标，不含本下标处的字符

<DT>Returns:<DD>the specified subsequence 指定的子序列

<DT>Throws:

<DD><CODE><A HREF="../../java/lang/IndexOutOfBoundsException.html" title="class in java.lang">IndexOutOfBoundsException</A></CODE> - if <tt>start</tt> or <tt>end</tt> are negative,

if <tt>end</tt> is greater than <tt>length()</tt>,

or if <tt>start</tt> is greater than <tt>end</tt>

如果start或end为负，end大于length，或者start大于end时抛出</DL>

</DD>

</DL>

<HR>

toString</H3>

<PRE>

public <A HREF="../../java/lang/String.html" title="class in java.lang">String</A> toString()</PRE>

<DL>

<DD>Returns a string containing the characters in this sequence in the same

order as this sequence. The length of the string will be the length of

this sequence.

将该字符序列按相同顺序转换成字符串。字符串的长度等于该序列的长度。

<DT>Overrides:<DD><CODE><A HREF="../../java/lang/Object.html#toString()">toString</A></CODE> in class <CODE><A HREF="../../java/lang/Object.html" title="class in java.lang">Object</A></CODE></DL>

</DD>

<DT>Returns:<DD>a string consisting of exactly this sequence of characters

包含该字符序列的字符串</DL>

</DD>

</DL>

<HR>

<TR>

<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../overview-summary.html">Overview</A> </TD>

<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-summary.html">Package</A> </TD>

<TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev">  Class </TD>

<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../deprecated-list.html">Deprecated</A> </TD>

<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../index-files/index-1.html">Index</A> </TD>

</TR>

</TABLE>

</TD>

JavaTM 2 Platform Std. Ed. v1.4.2

</TD>

</TR>

<TR>

 PREV CLASS 

<A HREF="../../java/lang/Cloneable.html" title="interface in java.lang">NEXT CLASS</A></TD>

<A HREF="../../index.html" target="_top">FRAMES</A>

<A HREF="CharSequence.html" target="_top">NO FRAMES</A>

<!--

if(window==top) {

document.writeln('<A HREF="../../allclasses-noframe.html">All Classes</A>');

}

//-->

</SCRIPT>

<A HREF="../../allclasses-noframe.html">All Classes</A>

</NOSCRIPT>

</TD>

</TR>

<TR>

SUMMARY: NESTED | FIELD | CONSTR | <A HREF="#method_summary">METHOD</A></TD>

DETAIL: FIELD | CONSTR | <A HREF="#method_detail">METHOD</A></TD>

</TR>

</TABLE>

<HR>

<a href="http://java.sun.com/cgi-bin/bugreport.cgi">Submit a bug or feature</a> For further API reference and developer documentation, see <a href="../../../relnotes/devdocs-vs-specs.html">Java 2 SDK SE Developer Documentation</a>. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples. Copyright 2003 Sun Microsystems, Inc. All rights reserved. Use is subject to <a href="../../../relnotes/license.html">license terms</a>. Also see the <a href="http://java.sun.com/docs/redist.html">documentation redistribution policy</a>.

</BODY>

</HTML>