全パッケージ クラス階層 このパッケージ 前項目 次項目 インデックス
java.lang.Object | +----java.lang.String
String クラスは文字型文字列を表します。 Java プログラムの "abc" などのリテラル文字列はすべて、このクラスのインスタンスとして実行されます。
文字列は定数です。この値を作成した後に変更はできません。文字列バッファは可変文字列をサポートします。文字列オブジェクトは不変であるため、共用することができます。
例えば :
String str = "abc";
は、下記と同じです :
char data[] = {'a', 'b', 'c'};
String str = new String(data);
文字列がどのように用いられるかについて、さらに例をあげます。
System.out.println("abc");
String cde = "cde";
System.out.println("abc" + cde);
String c = "abc".substring(2,3);
String d = cde.substring(1, 2);
クラス String には、シーケンスのそれぞれの文字をテストするメソッドや文字列の比較、文字列の検索、部分文字列の抽出、及び文字をすべて大文字または、小文字に変換した文字列のコピーの作成などのメソッドがあります。
Java 言語を使用すると、文字列連結演算子 ( + ) およびその他のオブジェクトから文字列への変換を特にサポートすることができます。文字列連結は StringBuffer クラスとその append メソッドを用いて実行します。文字列変換は toString メソッドを用いて実行し、 Object によって定義され、 Java のクラスすべてによって引き継がれます。文字列連結および文字列変換についてさらに情報を得る場合は、 Gosling、 Joy、および Steele の The Java Language Specification を参照して下さい。
String()
String を割り当てる。
String(byte[])
Stringを構築する。
String(byte[], int)
String を割り当てる。推奨されない。
String(byte[], int, int)
Stringを構築する。
String(byte[], int, int, int)
String を割り当てる。推奨されない。
String(byte[], int, int, String)
Stringを構築する。
String(byte[], String)
Stringを構築する。
String(char[])
String を割り当てて、文字型配列引数に現在含まれる文字型シーケンスを表す。
String(char[], int, int)
String を割り当てる。
String(String)
String(StringBuffer)
charAt(int)
compareTo(String)
concat(String)
copyValueOf(char[])
copyValueOf(char[], int, int)
endsWith(String)
equals(Object)
equalsIgnoreCase(String)
getBytes()
文字列をバイト列に変換し、結果を新しいバイト配列に保存する。
getBytes(int, int, byte[], int)
getBytes(String)
String をバイト列に変換し、結果を新しいバイト配列に保存する。
getChars(int, int, char[], int)
hashCode()
indexOf(int)
indexOf(int, int)
indexOf(String)
indexOf(String, int)
intern()
lastIndexOf(int)
lastIndexOf(int, int)
lastIndexOf(String)
lastIndexOf(String, int)
length()
regionMatches(boolean, int, String, int, int)
regionMatches(int, String, int, int)
replace(char, char)
oldChar をすべて newCharにオーバーライドした結果生じる新しい文字列を返す。
startsWith(String)
startsWith(String, int)
substring(int)
substring(int, int)
toCharArray()
toLowerCase()
Sting を小文字に変換する。
toLowerCase(Locale)
String のすべての文字を小文字に変換する。
toString()
toUpperCase()
toUpperCase(Locale)
String のすべての文字を大文字に変換する。
trim()
valueOf(boolean)
boolean の文字列表現を返す。
valueOf(char)
char * の文字列表現を返す。
valueOf(char[])
char の文字列表現を返す。
valueOf(char[], int, int)
char 内の指定された配列の文字列表現を返す。
valueOf(double)
double の文字列表現を返す。
valueOf(float)
float の文字列表現を返す。
valueOf(int)
int の文字列表現を返す。
valueOf(long)
long の文字列表現を返す。
valueOf(Object)
Object の文字列表現を返す。
String
public String()
String を割り当てます。
String
public String(String value)
String.
String
public String(char value[])
String を割り当てて、これが文字型配列引数に現在含まれている文字型シーケンスを表すようにします。
String
public String(char value[],
int offset,
int count)
String を割り当てます。引数 offset は部分配列の先頭の文字のインデックスであり、引数 count は部分配列の長さを指定します。
offsetおよび count 引数による文字列が value の範囲外となる場合、
String
public String(byte ascii[],
int hibyte,
int offset,
int count)
String 構築子を経由することです。
String を割り当てます。
引数 offset は部分配列の先頭のバイトのインデックスであり、 引数 count は部分配列の長さを指定します。
部分配列の各 byte は上記メソッドに指定される char に変換されます。
offsetまたは count が無効な場合
String
public String(byte ascii[],
int hibyte)
String 構築子を経由することです。
String を割り当てます。その結果として生じる文字列の各文字型 c は以下のようなバイト配列内の対応コンポーネント b から構成されます。
c == (char)(((hibyte & 0xff) << 8)
| (b & 0xff))
String
public String(byte bytes[],
int offset,
int length,
String enc) throws UnsupportedEncodingException
String を構築します。新しい String の長さはエンコーディングの関数であるため、部分配列長と一致しないことがあります。
String
public String(byte bytes[],
String enc) throws UnsupportedEncodingException
String を構築します。新しい String の長さはエンコーディングの関数であるため、バイト配列長と一致しないことがあります。
String
public String(byte bytes[],
int offset,
int length)
String を構築します。新しい String の長さはエンコーディングの関数であるため、部分配列の長さと一致しないことがあります。
String
public String(byte bytes[])
String を構築します。新しい String の長さはエンコーディングの関数であるため、バイト配列の長さと一致しないことがあります。
String
public String(StringBuffer buffer)
StringBuffer.
length
public int length()
charAt
public char charAt(int index)
0 から length() - 1 までです。
0 にある。
getChars
public void getChars(int srcBegin,
int srcEnd,
char dst[],
int dstBegin)
コピーされる最初の文字はインデックス srcBegin にあります。コピーされる最後の文字はインデックス srcEnd-1 にあります (このためコピーされる文字数の合計は srcEnd-srcBegin です)。文字列は、インデックス dstBegin で始まり以下のインデックスで終了する dst の部分配列にコピーされます。
dstbegin + (srcEnd-srcBegin) - 1
getBytes
public void getBytes(int srcBegin,
int srcEnd,
byte dst[],
int dstBegin)
getBytes(String enc) メソッドまたはプラットフォームのデフォルトのエンコーディングを使用する getBytes() メソッドを経由することです。
コピーされる先頭の文字はインデックス srcBegin であり、
コピーされる最後の文字はインデックス srcEnd-1 です。
コピーされる文字数の合計は srcEnd-srcBegin です。バイト列に変換される文字列は、インデックス dstBegin から始まり、以下のインデックスで終わる dst の部分配列にコピーされます。
dstbegin + (srcEnd-srcBegin) - 1
getBytes
public byte[] getBytes(String enc) throws UnsupportedEncodingException
String をバイト列に変換し、結果を新しいバイト配列に保存します。
getBytes
public byte[] getBytes()
String をバイト列に変換し、結果を新しいバイト配列に保存します。
equals
public boolean equals(Object anObject)
null でなく、このオブジェクトと同じ文字型シーケンスを表す String オブジェクトである場合に限り、この結果は true となります。
String
と比較するオブジェクト
String が等しい場合は true、
そうでない場合は false
equalsIgnoreCase
public boolean equalsIgnoreCase(String anotherString)
null でなく、このオブジェクトと同じ文字型シーケンスを表す String オブジェクトである場合に限り、この結果は true となります。ここでは文字のケースを無視します。
下記のうち少なくとも1つが true である場合、2 つの文字型は文字のケースを無視すると、同一と考えられます。
== によって比較)
Character.toUppercase を各文字型に適用した場合、同一の結果となる場合
Character.toLowercase を各文字型に適用した場合、同一の結果となる場合
シーケンス長が同一であり、対応する文字が文字ケースを無視して同一である場合、2 つの文字型シーケンスは文字ケースを無視すれば同一です。
String と比較する String
String が文字ケースを無視して等しい場合は true、そうでない場合は false
compareTo
public int compareTo(String anotherString)
String
0 、この文字列が辞書的に文字列引数より少ない場合は 0 未満の値、および文字列が辞書的に文字列引数より大きい場合は 0 より大きい値
regionMatches
public boolean regionMatches(int toffset,
String other,
int ooffset,
int len)
toffset または ooffset が負である場合、または
toffset+length がこの文字列の長さよりも大きい場合、もしくは
ooffset+length が引数の文字列の長さより大きい場合、このメソッドは
false を返します。
true 、
そうでない場合は false 。
regionMatches
public boolean regionMatches(boolean ignoreCase,
int toffset,
String other,
int ooffset,
int len)
toffset または ooffset が負である場合、または
toffset+length が、この文字列の長さよりも大きい場合、もしくは、
ooffset+length が引数の文字列の長さよりも大きい場合、このメソッドは
false を返します。
trueの場合、文字列を比較する時に文字ケースを無視する。
true 、
そうでない場合は false 。マッチングが正確であるか文字ケースを考慮しないかは ignoreCase によって異なる。
startsWith
public boolean startsWith(String prefix,
int toffset)
toffsetで始まるこのオブジェクトの部分文字列の先頭である場合はtrue 、そうでない場合はfalse。
startsWith
public boolean startsWith(String prefix)
true、 そうでない場合はfalse。
endsWith
public boolean endsWith(String suffix)
true、 そうでない場合は false 。
hashCode
public int hashCode()
indexOf
public int indexOf(int ch)
-1 。
indexOf
public int indexOf(int ch,
int fromIndex)
fromIndex 以上で表される文字シーケンスで文字が最初に見つかった場合はそのインデックス。または文字が見つからない場合は、-1 。
lastIndexOf
public int lastIndexOf(int ch)
-1 。
lastIndexOf
public int lastIndexOf(int ch,
int fromIndex)
fromIndex 以下で表される文字シーケンスで文字が最後に見つかったときは、そのインデックス。その位置より前で文字が見つからない場合は -1 。
indexOf
public int indexOf(String str)
-1 を返す。
indexOf
public int indexOf(String str,
int fromIndex)
fromIndex 以上のインデックスで、部分文字列として文字列引数が見つかった場合、この最初に見つかった部分文字列の先頭の文字のインデックスを返す。 fromIndex 以上で部分文字列として見つからない場合は、 -1 を返す。
lastIndexOf
public int lastIndexOf(String str)
this.length() で見つかると考えられます。
-1 を返す。
lastIndexOf
public int lastIndexOf(String str,
int fromIndex)
fromIndex 以下である必要があります。
fromIndex 以下のインデックスで見つかる場合、この最後の文字列で先頭の文字のインデックスを返す。 fromIndex より前で始まる部分文字列として見つからない場合は、-1 を返す。
substring
public String substring(int beginIndex)
beginIndex が範囲外である場合
substring
public String substring(int beginIndex,
int endIndex)
beginIndex で始まり、インデックス endIndex - 1 の文字まで続きます。
beginIndex または endIndex が範囲外である場合
concat
public String concat(String str)
引数文字列の長さが0 である場合、このオブジェクトを返します。
String の末尾に連結されるString。
replace
public String replace(char oldChar,
char newChar)
oldChar をすべて newChar に置き換えることによってできあがる新しい文字列を返します。
このオブジェクトによって表される文字シーケンスに oldChar が見つからない場合は、この文字列を返します。
oldChar が見つかるごとに newChar に置き換えることによってこの文字列から得られる文字列
toLowerCase
public String toLowerCase(Locale locale)
String の文字をすべて小文字に変換します。
toLowerCase
public String toLowerCase()
String を小文字に変換します。
Character に定義される toLowerCase メソッドの呼び出しに基づいて、文字列に異なる小文字バージョンを持つ文字型がない場合、オリジナルの文字列を返します。
そうでなければ、この文字列と同一の長さの新しい文字列を割り当て、異なる小文字バージョンを持つ文字列をそれぞれこの小文字の文字列にマップします。
toUpperCase
public String toUpperCase(Locale locale)
文字列の文字すべてを大文字に変換します。
toUpperCase
public String toUpperCase()
Character に定義される toUpperCase メソッドの呼び出しに基づいて、この文字列に異なる大文字バージョンを持つ文字型がない場合、オリジナルの文字列を返します。
そうでなければ、この文字列と同一の長さの新しい文字列を割り当て、異なる大文字バージョンを持つ文字列をそれぞれこの大文字の文字列にマップします。
trim
public String trim()
'\u0020' 以下 のコードを持つ文字 ( スペース文字 ) のすべてをホワイトスペースとみなします。
toString
public String toString()
toCharArray
public char[] toCharArray()
valueOf
public static String valueOf(Object obj)
Object の文字列表示を返します。
Object
null である場合、 "null" と等しい文字列、そうでない場合は obj.toString() の値を返す。
valueOf
public static String valueOf(char data[])
char の文字列表示を返します。
char 配列
valueOf
public static String valueOf(char data[],
int offset,
int count)
char の配列引数の指定した部分配列の文字列表現を返します。
引数 offset は部分配列の最初の文字型のインデックスです。引数 count は部分配列の長さを指定します。
String の値内の初期オフセット
String の値の長さ
copyValueOf
public static String copyValueOf(char data[],
int offset,
int count)
String
copyValueOf
public static String copyValueOf(char data[])
String
valueOf
public static String valueOf(boolean b)
boolean 型引数の文字列表現を返します。
boolean.
true である場合、
"true" と同じ文字列を返します。そうでない場合は、 "false" と同じ文字列を返す。
valueOf
public static String valueOf(char c)
char * 型引数の文字列表現を返します。
char.
c を 1 文字として含む長さ 1 の文字列。
valueOf
public static String valueOf(int i)
int 型引数の文字列表現を返します。
表現は、同じ引数の Integer.toString メソッド によって返されるものとまったく同じです。
int.
int 引数の文字列表現を含む文字列。
valueOf
public static String valueOf(long l)
long 型引数の文字列表現を返します。
表現は、同じ引数の Long.toString メソッドによって返されるものとまったく同じです。
long
long 引数の文字列表現を含む文字列。
valueOf
public static String valueOf(float f)
float 型引数の文字列表現を返します。
表現は、同じ引数の Float.toString メソッド によって返されるものとまったく同じです。
float
float 引数の文字列表現を含む文字列。
valueOf
public static String valueOf(double d)
double 型引数の文字列表現を返します。
表現は同じ引数の Double.toString メソッドによって返されるものとまったく同じです。
double
double 引数の文字列表現を含む文字列。
intern
public native String intern()
s および t が s.equals(t) のような文字列である場合、 以下を保証します。
s.intern() == t.intern().
全パッケージ クラス階層 このパッケージ 前項目 次項目 インデックス