クラス java.lang.String
全パッケージ クラス階層 このパッケージ 前項目 次項目 インデックス
クラス java.lang.String
java.lang.Object
|
+----java.lang.String
- public final class String
- extends Object
String を表現するオブジェクトの一般的なクラス。
String は定数であり、それらの値は作成後変更することはできない。
コンパイラは、各 String 定数から String オブジェクトを実際に生成することを
保証する。String オブジェクトは不変であるため、共有可能である。
たとえば:
String str = "abc";
は以下と同等である:
char data[] = {'a', 'b', 'c'};
String str = new String(data);
以下にもう少し String の使用方法の例を挙げる:
System.out.println("abc");
String cde = "cde";
System.out.println("abc" + cde);
String c = "abc".substring(2,3);
String d = cde.substring(1, 2);
- 参照:
- StringBuffer
-
String()
- 新しい空の String を作成する。
-
String(String)
- 指定した String のコピーである新規の String を作成する。
-
String(char[])
- 指定された文字配列が初期値である新規の String を
作成する。
-
String(char[], int, int)
- 指定された文字配列の一部が初期値である新規の String を作成する。
-
String(byte[], int, int, int)
- 指定されたバイトの配列の一部が初期値である新規の String を作成する。
-
String(byte[], int)
- 指定されたバイトの配列を値とする新規の String を作成する。
-
String(StringBuffer)
- 与えられた String バッファの現在の内容を値とする新規の String を
作成する。
-
charAt(int)
- 指定されたインデックスの文字を返す。
-
compareTo(String)
- String をもう1つの String と比較する。
-
concat(String)
- 指定された String を String の最後に連結する。
-
copyValueOf(char[], int, int)
- 指定された文字配列と等しい String を返す。
-
copyValueOf(char[])
- 指定された文字配列と等しい String を返す。
-
endsWith(String)
- String が指定されたサフィックスで終わるかどうか調べる。
-
equals(Object)
- String を指定されたオブジェクトと比較する。
-
equalsIgnoreCase(String)
- String をもう1つのオブジェクトと比較する。
-
getBytes(int, int, byte[], int)
- String から指定されたバイト配列へ文字をコピーする。
-
getChars(int, int, char[], int)
- String から指定された文字配列へ文字をコピーする。
-
hashCode()
- String のための hashcode を返す。
-
indexOf(int)
- String の中で、指定された文字が最初に出現する個所のインデックスを返す。
-
indexOf(int, int)
- String の中でfromIndex から検索を開始し、指定された文字が最初に
出現する個所のインデックスを返す。
-
indexOf(String)
- String の中で、指定された部分 String が最初に出現する個所のインデックスを返す。
-
indexOf(String, int)
- String の中で、指定された部分 String が最初に出現する個所のインデックスを返す。
-
intern()
- この String が持つ String に等しい String を返す。
-
lastIndexOf(int)
- String の中で、指定された文字が最後に出現する個所のインデックスを返す。
-
lastIndexOf(int, int)
- String の中で、指定された文字が最後に出現する個所のインデックスを返す。
-
lastIndexOf(String)
- String の中で、指定された部分 String が最後に出現する個所のインデックスを返す。
-
lastIndexOf(String, int)
- String の中で、指定された部分 String が最後に出現する個所のインデックスを返す。
-
length()
- String の長さを返す。
-
regionMatches(int, String, int, int)
- String のある範囲が、指定された String の指定された範囲と
一致するかどうか調べる。
-
regionMatches(boolean, int, String, int, int)
- String の範囲が、指定された String の指定された範囲と
一致するかどうか調べる。
-
replace(char, char)
- String に出現するすべての oldChar を newChar で置換する。
-
startsWith(String, int)
- String が指定されたプレフィックスより始まるかどうか調べる。
-
startsWith(String)
- String が指定されたプレフィックスより始まるかどうか調べる。
-
substring(int)
- String の部分 String を返す。
-
substring(int, int)
- String の部分 String を返す。
-
toCharArray()
- 文字配列に String を変換する。
-
toLowerCase()
- String の中のすべての文字を小文字に変換する。
-
toString()
- String に String を変換する。
-
toUpperCase()
- String の中のすべての文字を大文字に変換する。
-
trim()
- String から先頭、末尾にある空白を削除する。
-
valueOf(Object)
- オブジェクトの String 値を表現する String を返す。
-
valueOf(char[])
- 指定された文字配列と等しい String を返す。
-
valueOf(char[], int, int)
- 指定された文字配列と等しい String を返す。
-
valueOf(boolean)
- 指定された論理型値を表現する String オブジェクトを返す。
-
valueOf(char)
- 文字を1つだけ含んでいる String オブジェクトを返す。
-
valueOf(int)
- 整数型の値を表現する String オブジェクトを返す。
-
valueOf(long)
- long 型の値を表現する String オブジェクトを返す。
-
valueOf(float)
- float 型の値を表現する String オブジェクトを返す。
-
valueOf(double)
- double 型の値を表現する String オブジェクトを返す。
String
public String()
- 新しい空の String を作成する。
String
public String(String value)
- 指定した String のコピーである新規の String を作成する。
- パラメータ:
- value - - Stringの初期値
String
public String(char value[])
- 指定された文字配列が初期値である新規の String を
作成する。
- パラメータ:
- value - 字列の初期値
String
public String(char value[],
int offset,
int count)
- 指定された文字配列の一部が初期値である新規の String を作成する。
新規の String の長さは、指定された文字配列中で offset
から始まる文字数となる。
- パラメータ:
- value - String の初期値であり、文字の配列である。
- offset - String の値までのオフセット
- count - String の値の長さ
- 例外: StringIndexOutOfBoundsException
- 引数 offset, count が正しくない場合。
String
public String(byte ascii[],
int hibyte,
int offset,
int count)
- 指定されたバイトの配列の一部が初期値である新規の String を作成する。
各文字の上位バイトを指定することができる、それは通常 0 である。
新規の string の長さは、指定された文字配列中で offset から
始まる文字数となる。
- パラメータ:
- ascii - 文字に変換されるバイト
- hibyte - 各 unicode 文字の上位バイト
- offset - ASCII 配列までのオフセット
- count - String の長さ
- 例外: StringIndexOutOfBoundsException
- 引数 offset, count が正しくない場合。
String
public String(byte ascii[],
int hibyte)
- 指定されたバイトの配列を値とする新規の String を作成する。
バイト配列は各文字の上位バイトとして hibyte を使用する
ユニコードキャラクタに変換される。
- パラメータ:
- ascii - 文字に変換されるバイト
- hibyte - 各16ビットユニコードキャラクタの上位8ビット
String
public String(StringBuffer buffer)
- 与えられた String バッファの現在の内容を値とする新規の String を
作成する。
- パラメータ:
- buffer - 変換される String バッファ
length
public int length()
- String の長さを返す。
String の長さは、文字列中の16ビットユニコード文字の
数に等しい。
charAt
public char charAt(int index)
- 指定されたインデックスの文字を返す。インデックスの範囲は 0 から
length() - 1 までである。
- パラメータ:
- index - 要求する文字のインデックス
- 例外: StringIndexOutOfBoundsException
- インデックスが
0 to length()-1 の範囲内でない場合。
getChars
public void getChars(int srcBegin,
int srcEnd,
char dst[],
int dstBegin)
- String から指定された文字配列へ文字をコピーする。
(srcBegin と srcEnd によって決定される) 部分文字列の文字は、
配列中の dstBegin から始まる文字配列に
コピーされる。
- パラメータ:
- srcBegin - String の最初の文字のインデックス
- srcEnd - コピーされる String の最後尾
- dst - コピー先の配列
- dstBegin - コピー先の配列中の開始オフセット
getBytes
public void getBytes(int srcBegin,
int srcEnd,
byte dst[],
int dstBegin)
- String から指定されたバイト配列へ文字をコピーする。
(srcBegin と srcEnd によって決定される) 部分 String の文字は、
配列中の dstBegin から始まるバイト配列に
コピーされる。
- パラメータ:
- srcBegin - String の最初の文字のインデックス
- srcEnd - コピーされる String の最後尾
- dst - コピー先の配列
- dstBegin - コピー先の配列中の開始オフセット
equals
public boolean equals(Object anObject)
- String を指定されたオブジェクトと比較する。
オブジェクトと String が等しいとき、すなわち、
同じ並びで同じ長さと同じ文字を持つとき true を返す。
- パラメータ:
- anObject - String と比較するオブジェクト
- 返り値:
- String が等しいとき true; そうでなければ false。
- オーバーライド:
- クラス Object の equals
equalsIgnoreCase
public boolean equalsIgnoreCase(String anotherString)
- String をもう1つのオブジェクトと比較する。
オブジェクトと String が等しいとき、すなわち、
同じ並びで同じ長さと同じ文字を持つとき true を返す。
大文字は、比較される前に小文字に
変換される。
- パラメータ:
- anotherString - 比較される String
- 返り値:
- String が等しいとき true; そうでなければ false、ただし大文字、小文字の違いは無視される。
compareTo
public int compareTo(String anotherString)
- String をもう1つの String と比較する。
ゼロと比べて、小さいか、等しいか、大きい整数を返す。
整数の値は String が他方の String より、小さいか、等しいか、
大きいかによる。
- パラメータ:
- anotherString - 比較される String
regionMatches
public boolean regionMatches(int toffset,
String other,
int ooffset,
int len)
- String のある範囲が、指定された String の指定された範囲と
一致するかどうか調べる。
- パラメータ:
- toffset - String 中の調べ始める個所
- other - もう1つの String
- ooffset - もう1つの String 中の調べ始める個所
- len - 比較する文字数
- 返り値:
- 調べた範囲が一致した場合 true; さもなければ false。
regionMatches
public boolean regionMatches(boolean ignoreCase,
int toffset,
String other,
int ooffset,
int len)
- String の範囲が、指定された String の指定された範囲と
一致するかどうか調べる。もし論理型変数 ignoreCase が true であるなら、
大文字、小文字の違いは等しいと見なされる。
- パラメータ:
- ignoreCase - true ならば、大文字、小文字の違いは無視される
- toffset - String 中の調べ始める個所
- other - もう1つの String
- ooffset - もう1つの String 中の調べ始める個所
- len - 比較する文字数
- 返り値:
- 調べた範囲が一致した場合 true; さもなければ false。
startsWith
public boolean startsWith(String prefix,
int toffset)
- String が指定されたプレフィックスより始まるかどうか調べる。
- パラメータ:
- prefix - プレフィックス
- toffset - String 中の調べ始める個所
- 返り値:
- String が指定されたプレフィックスで始まっているとき true; さもなければ false。
startsWith
public boolean startsWith(String prefix)
- String が指定されたプレフィックスより始まるかどうか調べる。
- パラメータ:
- prefix - プレフィックス
- 返り値:
- String が指定されたプレフィックスで始まっているとき true; さもなければ false。
endsWith
public boolean endsWith(String suffix)
- String が指定されたサフィックスで終わるかどうか調べる。
- パラメータ:
- suffix - サフィックス
- 返り値:
- String が指定されたサフィックスで終わっているとき true; さもなければ false。
hashCode
public int hashCode()
- String のための hashcode を返す。これは String 中の
文字の値から作られる大きな数である。
- オーバーライド:
- クラス Object の hashCode
indexOf
public int indexOf(int ch)
- String の中で、指定された文字が最初に出現する個所のインデックスを返す。
このメソッドは、インデックスが見つからないとき -1 を返す。
- パラメータ:
- ch - 検索する文字
indexOf
public int indexOf(int ch,
int fromIndex)
- String の中でfromIndex から検索を開始し、指定された文字が最初に
出現する個所のインデックスを返す。
このメソッドは、インデックスが見つからないとき -1 を返す。
- パラメータ:
- ch - 検索する文字
- fromIndex - 検索を開始するインデックス
lastIndexOf
public int lastIndexOf(int ch)
- String の中で、指定された文字が最後に出現する個所のインデックスを返す。
String は最後の文字から逆向きに検索される。
このメソッドは、インデックスが見つからないとき -1 を返す。
- パラメータ:
- ch - 検索する文字
lastIndexOf
public int lastIndexOf(int ch,
int fromIndex)
- String の中で、指定された文字が最後に出現する個所のインデックスを返す。
String は fromIndex から逆向きに検索される。
このメソッドは、インデックスが見つからないとき -1 を返す。
- パラメータ:
- ch - 検索する文字
- fromIndex - 検索を開始するインデックス
indexOf
public int indexOf(String str)
- String の中で、指定された部分 String が最初に出現する個所のインデックスを返す。
このメソッドは、インデックスが見つからないとき -1 を返す。
- パラメータ:
- str - 検索する文字
indexOf
public int indexOf(String str,
int fromIndex)
- String の中で、指定された部分 String が最初に出現する個所のインデックスを返す。
fromIndex から検索を開始する。
このメソッドは、インデックスが見つからないとき -1 を返す。
- パラメータ:
- str - 検索する String
- fromIndex - 検索を開始するインデックス
lastIndexOf
public int lastIndexOf(String str)
- String の中で、指定された部分 String が最後に出現する個所のインデックスを返す。
String は逆向きに検索される。
このメソッドは、インデックスが見つからないとき -1 を返す。
- パラメータ:
- str - 検索する String
lastIndexOf
public int lastIndexOf(String str,
int fromIndex)
- String の中で、指定された部分 String が最後に出現する個所のインデックスを返す。
String は fromIndex から逆向きに検索される。
このメソッドは、インデックスが見つからないとき -1 を返す。
- パラメータ:
- str - 検索する String
- fromIndex - 検索を開始するインデックス
substring
public String substring(int beginIndex)
- String の部分 String を返す。 部分 String は beginIndex (これを含む)と
文字列の終わりによって指定される。
- パラメータ:
- beginIndex - 先頭のインデックス。部分 String に含まれる。
substring
public String substring(int beginIndex,
int endIndex)
- String の部分 String を返す。 部分 String は beginIndex (これを含む)と
endIndex (これは含まれない)によって指定される。
- パラメータ:
- beginIndex - 先頭のインデックス。部分 String に含まれる。
- endIndex - 最後のインデックス。部分 String に含まれない。
- 例外: StringIndexOutOfBoundsException
- beginIndex または
endIndex が範囲外である場合。
concat
public String concat(String str)
- 指定された String を String の最後に連結する。
- パラメータ:
- str - 最後に連結する String
replace
public String replace(char oldChar,
char newChar)
- String に出現するすべての oldChar を newChar で置換する。
- パラメータ:
- oldChar - 元の文字
- newChar - 新しい文字
toLowerCase
public String toLowerCase()
- String の中のすべての文字を小文字に変換する。
- 返り値:
- 小文字に変換された String。
- 参照:
- toLowerCase, toUpperCase
toUpperCase
public String toUpperCase()
- String の中のすべての文字を大文字に変換する。
- 返り値:
- 大文字に変換された String。
- 参照:
- toUpperCase, toLowerCase
trim
public String trim()
- String から先頭、末尾にある空白を削除する。
- 返り値:
- 空白を取り除いた String。
toString
public String toString()
- String に String を変換する。
- 返り値:
- String そのもの。
- オーバーライド:
- クラス Object の toString
toCharArray
public char[] toCharArray()
- 文字配列に String を変換する。これにより新しい配列を生成する。
- 返り値:
- 文字の配列。
valueOf
public static String valueOf(Object obj)
- オブジェクトの String 値を表現する String を返す。
toString() メソッドの実装により、オブジェクトそのものの表現法には
選択の余地がある。
- パラメータ:
- obj - 変換されるオブジェクト
valueOf
public static String valueOf(char data[])
- 指定された文字配列と等しい String を返す。
オリジナルの配列を文字列のボディとして使用する(すなわち、それを
新しい配列にコピーしない)。
- パラメータ:
- data - 文字配列
valueOf
public static String valueOf(char data[],
int offset,
int count)
- 指定された文字配列と等しい String を返す。
- パラメータ:
- data - 文字配列
- offset - String の値へのオフセット
- count - String の値の長さ
copyValueOf
public static String copyValueOf(char data[],
int offset,
int count)
- 指定された文字配列と等しい String を返す。
新しい配列を生成し、文字をそれにコピーする。
- パラメータ:
- data - 文字配列
- offset - String の値へのオフセット
- count - String の値の長さ
copyValueOf
public static String copyValueOf(char data[])
- 指定された文字配列と等しい String を返す。
新しい配列を生成し、文字をそれにコピーする。
- パラメータ:
- data - 文字配列
valueOf
public static String valueOf(boolean b)
- 指定された論理型値を表現する String オブジェクトを返す。
- パラメータ:
- b - 論理型値
valueOf
public static String valueOf(char c)
- 文字を1つだけ含んでいる String オブジェクトを返す。
- パラメータ:
- c - 文字
- 返り値:
- 生成される String 。
valueOf
public static String valueOf(int i)
- 整数型の値を表現する String オブジェクトを返す。
- パラメータ:
- i - 整数
valueOf
public static String valueOf(long l)
- long 型の値を表現する String オブジェクトを返す。
- パラメータ:
- l - long 型の値
valueOf
public static String valueOf(float f)
- float 型の値を表現する String オブジェクトを返す。
- パラメータ:
- f - float 型の値
valueOf
public static String valueOf(double d)
- double 型の値を表現する String オブジェクトを返す。
- パラメータ:
- d - double 型の値
intern
public String intern()
- この String が持つ String に等しい String を返す。
この返される String は、唯一つであることが保証される。例:
s1.intern() == s2.intern() <=> s1.equals(s2).
全パッケージ クラス階層 このパッケージ 前項目 次項目 インデックス
本マニュアルに関する著作権および商標