JavaTM 2 Platform
Standard Ed. 5.0

java.lang
インタフェース CharSequence

既知の実装クラスの一覧:
CharBuffer, String, StringBuffer, StringBuilder

public interface CharSequence

CharSequencechar 値の読むことのできる文字シーケンスです。このインタフェースは、さまざまな種類の char シーケンスへの統一された読み取り専用アクセスを提供します。char 値は、基本多言語面 (BMP) またはサロゲートの文字を表します。詳細は、Unicode 文字表現を参照してください。

このインタフェースは、equals および hashCode メソッドの汎用規約を洗練させるものではありません。このため、CharSequence を実装する 2 つのオブジェクトの比較結果は、通常、定義されていません。各オブジェクトを異なるクラスを使用して実装できるため、各クラスがそのインスタンスを他のクラスのインスタンスと等価かどうか検査できるという保証はありません。したがって、セットの要素としてまたはマップのキーとして、任意の CharSequence インスタンスを使うのは不適切です。

導入されたバージョン:
1.4

メソッドの概要
 char charAt(int index)
          指定されたインデックス位置にある char 値を返します。
 int length()
          この文字シーケンスの長さを返します。
 CharSequence subSequence(int start, int end)
          このシーケンスのサブシーケンスである新規 CharSequence を返します。
 String toString()
          このシーケンス内の文字を含む文字列を、このシーケンスと同じ順序で返します。
 

メソッドの詳細

length

int length()
この文字シーケンスの長さを返します。長さはシーケンス内の 16 ビット char の数に等しくなります。

戻り値:
このシーケンスの char の数

charAt

char charAt(int index)
指定されたインデックス位置にある char 値を返します。インデックスは、0 から length() - 1 の範囲になります。配列のインデックス付けの場合と同じように、シーケンスの最初の char のインデックスは 0、次の文字のインデックスは 1 と続きます。

インデックスで指定された char 値がサロゲート の場合、サロゲート値が返されます。

パラメータ:
index - 返される char 値のインデックス
戻り値:
指定された char
例外:
IndexOutOfBoundsException - index 引数が負の値または length() より小さい場合

subSequence

CharSequence subSequence(int start,
                         int end)
このシーケンスのサブシーケンスである新規 CharSequence を返します。サブシーケンスは、指定されたインデックスの char 値で始まり、インデックス end - 1char 値で終わります。返される (char の) シーケンスの長さは end - start です。このため、start == end の場合、空のシーケンスが返されます。

パラメータ:
start - 開始インデックス (この値を含む)
end - 終了インデックス (この値を含まない)
戻り値:
指定されたサブシーケンス
例外:
IndexOutOfBoundsException - start または end が負の値の場合、endlength() より大きい場合、あるいは startend より大きい場合

toString

String toString()
このシーケンス内の文字を含む文字列を、このシーケンスと同じ順序で返します。このシーケンスの長さが、文字列の長さになります。

オーバーライド:
クラス Object 内の toString
戻り値:
この文字列シーケンスだけで構成された文字列

JavaTM 2 Platform
Standard Ed. 5.0

バグの報告と機能のリクエスト
さらに詳しい API リファレンスおよび開発者ドキュメントについては、Java 2 SDK SE 開発者用ドキュメントを参照してください。開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、およびコード実例が含まれています。

Copyright 2004 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。