- java.lang.Object
-
- java.lang.String
-
- 実装されているすべてのインターフェース
-
Serializable,CharSequence,Comparable<String>
public final class String extends Object implements Serializable, Comparable<String>, CharSequence
String类表示字符串。 Javaプログラム内のすべての文字列リテラル(例:"abc")すべてこのクラスのインスタンスとして実装される。文字列は不変です; それらの値は作成後に変更できません。 字符串缓冲区支持可变字符串。 Stringオブジェクトは不変であるため、それらを共有できます。 例如:
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シーケンスの各文字を検査し、文字列を比較し、文字列を検索し、部分文字列を抽出し、大文字または小文字に変換されたすべての文字を含む文字列のコピーを作成するためのメソッドが含まれています。 案例映射基于Characterクラスで指定されたUnicode標準のバージョン。Java言語は、文字列連結演算子(+)と、他のオブジェクトを文字列に変換することに対して特別なサポートを提供します。 文字列の連結と変換に関するその他の情報については、次を参照してください。Java语言规范 。
除非另有说明,否则将
null参数传递给null中のコンストラクタまたはメソッドは、例外のスローを引き起こします。NullPointerException。甲
String表示,其中补充字符由サロゲートペアUTF-16形式で表される文字列(第Unicode Character RepresentationsにCharacter以获取更多信息类)。 インデックス値は...を指すcharコード単位であるため、補助文字はString使用两个位置。Stringクラスは、Unicodeコードポイント(つまり文字)を処理するメソッドと、Unicodeコードユニット(つまりchar値)のメソッド。特に断りのない限り、文字列を比較するメソッドはロケールを考慮しません。
Collatorクラスは、より細かい粒度の、ロケール依存のString比較メソッドを提供します。- Implementation Note:
-
只要编译器最终符合Java言語仕様、文字列連結演算子の実装はJavaコンパイラによって決定されます。
例如,
javac编译器可实现运营商StringBuffer,StringBuilder,或java.lang.invoke.StringConcatFactory取决于JDK版本。 文字列変換の実装は通常、メソッドによって行われますtoString,由Object定義され、Javaのすべてのクラスに継承されます。 - 以下のバージョンから:
- 1.0
- 另请参见:
-
Object.toString(),StringBuffer,StringBuilder,Charset, Serialized Form - See The Java™ Language Specification:
- 15.18.1 文字列連結演算子+
-
-
フィールドの概要
字段 変数と型 字段 描述 static Comparator<String>CASE_INSENSITIVE_ORDER由compareToIgnoreCase订购Stringオブジェクトの比較compareToIgnoreCase。
-
コンストラクタの概要
构造方法 构造器 描述 String()新しく作成されたものを初期化するStringオブジェクトを、空の文字シーケンスを表すようにします。String(byte[] bytes)プラットフォームのデフォルト文字セットを使用して指定されたバイト配列をデコードすることによって、新しいString。String(byte[] ascii, int hibyte)已过时。このメソッドはバイトを文字に正しく変換できません。String(byte[] bytes, int offset, int length)プラットフォームのデフォルト文字セットを使用して指定されたバイト部分配列をデコードすることにより、新しい文字列を構築します。String。String(byte[] ascii, int hibyte, int offset, int count)已过时。このメソッドはバイトを文字に正しく変換できません。String(byte[] bytes, int offset, int length, String charsetName)指定された文字セットを使用して指定されたバイトサブ配列をデコードすることによりString新しい...を構築するString。String(byte[] bytes, int offset, int length, Charset charset)String(byte[] bytes, String charsetName)新しい...を構築するString指定されたバイト配列を使用してデコードされますcharset 。String(byte[] bytes, Charset charset)新しい...を構築するString指定されたバイト配列を使用してデコードされますcharset 。String(char[] value)新しい...を割り当てるString、現在文字配列パラメータに含まれている文字シーケンスを表すようにします。String(char[] value, int offset, int count)新しい...を割り当てるString、文字配列引数のサブ配列内の文字を含みます。String(int[] codePoints, int offset, int count)新しい...を割り当てるString,其中包含 Unicode code point配列引数のサブ配列内の文字。String(String original)新しく作成されたものを初期化するStringオブジェクトを、パラメータと同じ文字シーケンスを表すようにします; 言い換えれば、新しく作成された文字列は、パラメータ文字列のコピーです。String(StringBuffer buffer)文字列バッファ引数に現在含まれている文字シーケンスを含む新しい文字列を割り当てます。String(StringBuilder builder)文字列ビルダー引数に現在含まれている文字シーケンスを含む新しい文字列を割り当てます。
-
メソッドの概要
所有方法 静的メソッド インスタンスメソッド 具体的な方法 非推奨のメソッド 変数と型 方法 描述 charcharAt(int index)指定されたインデックスにあるchar值。IntStreamchars()返回intのストリームは、このシーケンス内のchar值零扩展。intcodePointAt(int index)指定されたインデックスの文字(Unicodeコードポイント)を返します。intcodePointBefore(int index)指定されたインデックスの前の文字(Unicodeコードポイント)を返します。intcodePointCount(int beginIndex, int endIndex)返回此Stringの指定テキスト範囲内のUnicodeコードポイントの数。IntStreamcodePoints()このシーケンス内のコードポイント値のストリームを返します。intcompareTo(String anotherString)按字典顺序比较两个字符串。intcompareToIgnoreCase(String str)按字典顺序比较两个字符串,忽略大小写差异。Stringconcat(String str)指定された文字列をこの文字列の末尾に連結します。booleancontains(CharSequence s)この文字列が指定されたchar値のシーケンスを含む場合に限り、trueを返します。booleancontentEquals(CharSequence cs)この文字列と指定されたCharSequence。booleancontentEquals(StringBuffer sb)この文字列と指定されたStringBuffer。static StringcopyValueOf(char[] data)相当于valueOf(char[])。static StringcopyValueOf(char[] data, int offset, int count)booleanendsWith(String suffix)この文字列が指定されたサフィックスで終わるかどうかをテストします。booleanequals(Object anObject)この文字列を指定されたオブジェクトと比較します。booleanequalsIgnoreCase(String anotherString)将此String別の...とString大文字と小文字を無視して比較します。static Stringformat(String format, Object... args)指定された書式文字列と引数を使用して、フォーマットされた文字列を返します。static Stringformat(Locale l, String format, Object... args)指定されたロケール、書式文字列、および引数を使用して、書式付き文字列を返します。byte[]getBytes()プラットフォームのデフォルト文字セットを使用してこれをStringバイトシーケンスにエンコードし、結果を新しいバイト配列に格納します。voidgetBytes(int srcBegin, int srcEnd, byte[] dst, int dstBegin)已过时。このメソッドは文字をバイトに正しく変換できません。byte[]getBytes(String charsetName)名前付き文字セットを使用して、このStringバイトシーケンスにエンコードし、結果を新しいバイト配列に格納します。byte[]getBytes(Charset charset)指定されたものを使うcharset将此Stringバイトシーケンスにエンコードし、結果を新しいバイト配列に格納します。voidgetChars(int srcBegin, int srcEnd, char[] dst, int dstBegin)この文字列内の文字を宛先の文字配列にコピーします。inthashCode()この文字列のハッシュコードを返します。intindexOf(int ch)指定された文字が最初に出現する文字列内のインデックスを返します。intindexOf(int ch, int fromIndex)指定された文字がこの文字列内で最初に出現するインデックスを、指定されたインデックスから検索して返します。intindexOf(String str)指定された部分文字列が最初に出現する文字列内のインデックスを返します。intindexOf(String str, int fromIndex)指定されたインデックスから開始して、指定された部分文字列が最初に出現する文字列内のインデックスを返します。Stringintern()文字列オブジェクトの標準表現を返します。booleanisBlank()booleanisEmpty()static Stringjoin(CharSequence delimiter, CharSequence... elements)返回由CharSequence elementsのコピーから構成される新しいString、そのコピーと指定されたdelimiterのコピーを連結します。static Stringjoin(CharSequence delimiter, Iterable<? extends CharSequence> elements)返回由Stringのコピーで構成される新しいString,其中CharSequence elements指定されたdelimiterのコピー。intlastIndexOf(int ch)指定された文字が最後に出現する文字列内のインデックスを返します。intlastIndexOf(int ch, int fromIndex)指定された文字が最後に出現する文字列内のインデックスを返し、指定されたインデックスから後方に検索します。intlastIndexOf(String str)指定された部分文字列が最後に出現する文字列内のインデックスを返します。intlastIndexOf(String str, int fromIndex)指定された部分文字列が最後に出現する文字列内のインデックスを、指定されたインデックスから後方に検索して返します。intlength()この文字列の長さを返します。Stream<String>lines()この文字列から抽出された行のストリームを、行終端文字で区切って返します。booleanmatches(String regex)この文字列が指定されたものと等しいかどうかを判断するregular expression匹配。intoffsetByCodePoints(int index, int codePointOffset)返回此String内のインデックス、そのインデックスは指定されたindex偏移codePointOffset代码点。booleanregionMatches(boolean ignoreCase, int toffset, String other, int ooffset, int len)2つの文字列領域が等しいかどうかをテストします。booleanregionMatches(int toffset, String other, int ooffset, int len)2つの文字列領域が等しいかどうかをテストします。Stringrepeat(int count)その値がこの文字列の連結繰り返しである文字列を返します。count次。Stringreplace(char oldChar, char newChar)すべての出現箇所を置換した結果の文字列を返します。oldCharこの文字列ではnewChar。Stringreplace(CharSequence target, CharSequence replacement)この文字列内のリテラルターゲットシーケンスに一致する各部分文字列を、指定されたリテラル置換シーケンスに置き換えます。StringreplaceAll(String regex, String replacement)指定された置換で指定されたregular expression一致したこの文字列の各部分文字列を置換します。StringreplaceFirst(String regex, String replacement)指定された置換で指定されたregular expressionこの文字列の一致する最初の部分文字列を置換します。String[]split(String regex)String[]split(String regex, int limit)booleanstartsWith(String prefix)この文字列が指定されたプレフィックスで始まるかどうかをテストします。booleanstartsWith(String prefix, int toffset)指定されたインデックスから始まるこの文字列の部分文字列が、指定されたプレフィックスで始まるかどうかをテストします。Stringstrip()この文字列を値とし、先頭と末尾のすべての空白を削除した文字列を返します。white space。StringstripLeading()先頭にあるすべてのものを削除した、この文字列を値として持つ文字列を返します。white space。StringstripTrailing()この文字列を値とし、すべての末尾を削除した文字列を返します。white space。CharSequencesubSequence(int beginIndex, int endIndex)このシーケンスの部分シーケンスである文字シーケンスを返します。Stringsubstring(int beginIndex)この文字列の部分文字列である文字列を返します。Stringsubstring(int beginIndex, int endIndex)この文字列の部分文字列である文字列を返します。char[]toCharArray()この文字列を新しい文字配列に変換します。StringtoLowerCase()デフォルトのロケールの規則を使用して、この...Stringすべての文字を小文字に変換します。StringtoLowerCase(Locale locale)使用给定Localeの規則はこれをStringすべての文字を変換するLocale。StringtoString()このオブジェクト(すでに文字列です!)StringtoUpperCase()デフォルトのロケールの規則を使用して、この...Stringすべての文字を大文字に変換します。StringtoUpperCase(Locale locale)使用给定Localeの規則はこれをStringすべての文字を大文字に変換します。Stringtrim()この文字列を値とし、すべての先頭および末尾の空白が取り除かれた文字列を返します。ここで、spaceはコードポイントが...以下である文字として定義されます。'U+0020'(空白文字)の任意の文字。static StringvalueOf(boolean b)返回boolean引数の文字列表現。static StringvalueOf(char c)返回char引数の文字列表現。static StringvalueOf(char[] data)返回char配列引数の文字列表現。static StringvalueOf(char[] data, int offset, int count)返回char配列引数の特定のサブ配列の文字列表現。static StringvalueOf(double d)返回double引数の文字列表現。static StringvalueOf(float f)返回float引数の文字列表現。static StringvalueOf(int i)返回int引数の文字列表現。static StringvalueOf(long l)返回long引数の文字列表現。static StringvalueOf(Object obj)返回Object引数の文字列表現。
-
-
-
フィールドの詳細
-
CASE_INSENSITIVE_ORDER
public static final Comparator<String> CASE_INSENSITIVE_ORDER
由compareToIgnoreCase订购Stringオブジェクトの比較compareToIgnoreCase。 このコンパレータは直列化可能です。请注意,此比较器不会ロケールを考慮し、一部のロケールではソート順序が不満足になる場合があります。
Collatorクラスはロケール依存の比較を提供します。- 以下のバージョンから:
- 1.2
- 另请参见:
-
Collator
-
-
コンストラクタの詳細
-
String
public String()
新しく作成されたものを初期化するStringオブジェクトを、空の文字シーケンスを表すようにします。 文字列は不変であるため、このコンストラクタを使用する必要がないことに注意してください。
-
String
public String(String original)
新しく作成されたものを初期化するStringオブジェクトを、パラメータと同じ文字シーケンスを表すようにします; 言い換えれば、新しく作成された文字列は、パラメータ文字列のコピーです。 除非需要originalの明示的なコピー、original文字列は不変であるため、このコンストラクタを使用する必要はありません。- 参数
-
original- AString
-
String
public String(char[] value)
新しい...を割り当てるString、現在文字配列パラメータに含まれている文字シーケンスを表すようにします。 文字配列の内容をコピーします; その後の文字配列の変更は、新しく作成された文字列に影響しません。- 参数
-
value- 文字列の初期値
-
String
public String(char[] value, int offset, int count)新しい...を割り当てるString、文字配列引数のサブ配列内の文字を含みます。offsetパラメータは部分countの最初の文字のインデックス、count参数指定子countの長さ。 サブ配列の内容をコピーします; その後の文字配列の変更は、新しく作成された文字列に影響しません。- 参数
-
value文字ソースとしての配列 -
offset- 初期オフセット -
count- 长度 - 异常
-
IndexOutOfBoundsException- 如果offset負の数ならば、count負の数、またはoffsetより大きいvalue.length - count
-
String
public String(int[] codePoints, int offset, int count)新しい...を割り当てるString,其中包含Unicode code point配列引数のサブ配列内の文字。offsetパラメータは部分countの最初のコードポイントのインデックス、count参数指定子countの長さ。 サブ配列の内容を変換してchars; 后续修改int配列は新しく作成された文字列に影響しません。- 参数
-
codePoints- Unicodeコードポイントのソースとなる配列 -
offset- 初期オフセット -
count- 长度 - 异常
-
IllegalArgumentException- にある場合codePoints無効なUnicodeコードポイントが見つかった場合 -
IndexOutOfBoundsException- 如果offset負の数ならば、count負の数、またはoffsetより大きいcodePoints.length - count - 以下のバージョンから:
- 1.5
-
String
@Deprecated(since="1.1") public String(byte[] ascii, int hibyte, int offset, int count)
Deprecated.This method does not properly convert bytes into characters. As of JDK 1.1, the preferred way to do this is via theStringconstructors that take aCharset, charset name, or that use the platform's default charset.8ビット整数値の配列のサブ配列から構成される新しい文字列を割り当てます。String。offsetパラメータは部分countの最初のバイトのインデックス、count参数指定子countの長さ。每个
byte部分配列が変換される際char指定としてString(byte[],int)构造。- 参数
-
ascii文字に変換するバイト数 -
hibyte- 各16ビットUnicodeコードユニットの上位8ビット -
offset- 初期オフセット -
count- 长度 - 异常
-
IndexOutOfBoundsException- 如果offset負の数であり、count負の数、またはoffset負であるascii.length - count - 另请参见:
-
String(byte[], int),String(byte[], int, int, java.lang.String),String(byte[], int, int, java.nio.charset.Charset),String(byte[], int, int),String(byte[], java.lang.String),String(byte[], java.nio.charset.Charset),String(byte[])
-
String
@Deprecated(since="1.1") public String(byte[] ascii, int hibyte)
Deprecated.This method does not properly convert bytes into characters. As of JDK 1.1, the preferred way to do this is via theStringconstructors that take aCharset, charset name, or that use the platform's default charset.新しい...を割り当てるString其中包含由8位整数值数组Stringの文字。 結果文字列内の各文字cすべてバイト配列内の対応するコンポーネントからb構築される。次のようになる:c == (char)(((hibyte & 0xff) << 8) | (b & 0xff))- 参数
-
ascii文字に変換するバイト数 -
hibyte- 各16ビットUnicodeコードユニットの上位8ビット - 另请参见:
-
String(byte[], int, int, java.lang.String),String(byte[], int, int, java.nio.charset.Charset),String(byte[], int, int),String(byte[], java.lang.String),String(byte[], java.nio.charset.Charset),String(byte[])
-
String
public String(byte[] bytes, int offset, int length, String charsetName) throws UnsupportedEncodingException指定された文字セットを使用して指定されたバイトサブ配列をデコードすることによりString新しい...を構築するString。 新しいStringの長さは文字セットの関数であるため、部分配列の長さと等しくない場合があります。指定されたバイトが指定された文字セットで無効な場合、このコンストラクタの動作は未指定です。 当需要更多地控制解码过程时,应使用
CharsetDecoder类。- 参数
-
bytes文字にデコードするバイト -
offsetデコードする最初のバイトのインデックス -
length- デコードするバイト数 -
charsetName- サポートされたcharsetの名前 - 异常
-
UnsupportedEncodingException指定された文字セットがサポートされていない場合 -
IndexOutOfBoundsException- 如果offset負の数であり、length負の数、またはoffsetより大きいbytes.length - length - 以下のバージョンから:
- 1.1
-
String
public String(byte[] bytes, int offset, int length, Charset charset)新しい...を構築するString指定されたバイトの部分配列を使用してデコードします。charset 。 新Stringの長さは文字セットの関数であり、したがってサブStringの長さ。このメソッドは常に、このcharsetのデフォルトの置換文字列を使用して、形式が正しくない入力とマップできない文字シーケンスを置き換えます。 当需要更多地控制解码过程时,应使用
CharsetDecoder类。- 参数
-
bytes文字にデコードするバイト -
offsetデコードする最初のバイトのインデックス -
length- デコードするバイト数 -
charset-该charsetデコードに使用されるbytes - 异常
-
IndexOutOfBoundsException- 如果offset負の数であり、length負の数、またはoffsetより大きいbytes.length - length - 以下のバージョンから:
- 1.6
-
String
public String(byte[] bytes, String charsetName) throws UnsupportedEncodingException新しい...を構築するString指定されたバイト配列を使用してデコードされますcharset 。 新Stringの長さは文字セットの関数であり、したがってバイト配列の長さと等しくない場合があります。指定されたバイトが指定された文字セットで無効な場合、このコンストラクタの動作は未指定です。 当需要更多地控制解码过程时,应使用
CharsetDecoder类。- 参数
-
bytes文字にデコードするバイト -
charsetName- サポートされたcharsetの名前 - 异常
-
UnsupportedEncodingException指定された文字セットがサポートされていない場合 - 以下のバージョンから:
- 1.1
-
String
public String(byte[] bytes, Charset charset)新しい...を構築するString指定されたバイト配列を使用してデコードされますcharset 。 新Stringの長さは文字セットの関数であり、したがってバイト配列の長さと等しくない場合があります。このメソッドは常に、このcharsetのデフォルトの置換文字列を使用して、形式が正しくない入力とマップできない文字シーケンスを置き換えます。 当需要更多地控制解码过程时,应使用
CharsetDecoder类。- 参数
-
bytes文字にデコードするバイト -
charset-该charsetデコードに使用されるbytes - 以下のバージョンから:
- 1.6
-
String
public String(byte[] bytes, int offset, int length)プラットフォームのデフォルト文字セットを使用して指定されたバイト部分配列をデコードすることにより、新しい文字列を構築します。String。 新Stringの長さは文字セットの関数であり、したがってサブStringの長さ。指定されたバイトがデフォルトの文字セットで無効である場合のこのコンストラクタの動作は未指定です。 当需要更多地控制解码过程时,应使用
CharsetDecoder类。- 参数
-
bytes文字にデコードするバイト -
offsetデコードする最初のバイトのインデックス -
length- デコードするバイト数 - 异常
-
IndexOutOfBoundsException- 如果offset負の数ならば、length負の数、またはoffsetより大きいbytes.length - length - 以下のバージョンから:
- 1.1
-
String
public String(byte[] bytes)
プラットフォームのデフォルト文字セットを使用して指定されたバイト配列をデコードし、新しいものを構築しますString。 新Stringの長さは文字セットの関数であり、したがってバイト配列の長さと等しくない場合があります。指定されたバイトがデフォルトの文字セットで無効である場合のこのコンストラクタの動作は未指定です。 当需要更多地控制解码过程时,应使用
CharsetDecoder类。- 参数
-
bytes文字にデコードするバイト - 以下のバージョンから:
- 1.1
-
String
public String(StringBuffer buffer)
文字列バッファ引数に現在含まれている文字シーケンスを含む新しい文字列を割り当てます。 文字列バッファの内容をコピーします。 後続の文字列バッファの変更は、新しく作成された文字列には影響しません。- 参数
-
buffer- AStringBuffer
-
String
public String(StringBuilder builder)
文字列ビルダー引数に現在含まれている文字シーケンスを含む新しい文字列を割り当てます。 StringBuilderの内容がコピーされます; 後続の文字列ビルダーの変更は、新しく作成された文字列には影響しません。このコンストラクタは、移行を容易にするために提供されています
StringBuilder。 通过toStringStringBuilderから文字列を取得するメソッドは、より高速に実行される可能性があり、通常は推奨されます。- 参数
-
builder- AStringBuilder - 以下のバージョンから:
- 1.5
-
-
メソッドの詳細
-
length
public int length()
この文字列の長さを返します。 長さは文字列内の...と等しいUnicode code unitsの数量。- Specified by:
-
lengthインターフェースでCharSequence - 结果
- このオブジェクトが表す文字シーケンスの長さ。
-
isEmpty
public boolean isEmpty()
- 结果
-
true如果length()である0,否则false - 以下のバージョンから:
- 1.6
-
charAt
public char charAt(int index)
指定されたインデックスにあるchar值。 インデックス範囲は0至length() - 1。 シーケンスの最初のchar值位于索引0,下一个位于索引1,依此类推,就像数组索引一样。如果
charインデックスで指定された値はsurrogate ,则返回所述替代值。- Specified by:
-
charAtインターフェースでCharSequence - 参数
-
index-char値のインデックス。 - 结果
-
この文字列の指定されたインデックスにおける
char值。 第一个char值位于索引0。 - 异常
-
IndexOutOfBoundsException- 如果index引数が負の場合、またはこの文字列の長さ以上の場合。
-
codePointAt
public int codePointAt(int index)
指定されたインデックスの文字(Unicodeコードポイント)を返します。 索引引用char値(Unicodeコード単位)、範囲は0到length()- 1。もし与えられたインデックスにある指定された
char值处于高代理范围内,则以下索引小于此Stringの長さ、および以下のインデックスにあるchar値が低サロゲート範囲にある場合、そのサロゲートペアに対応する補助コードポイントが返されます。 そうでなければ、与えられたインデックスのchar值。- 参数
-
index-char値のインデックス - 结果
-
index位置の文字のコードポイント値 - 异常
-
IndexOutOfBoundsException- 如果index引数が負の場合、またはこの文字列の長さ以上の場合。 - 以下のバージョンから:
- 1.5
-
codePointBefore
public int codePointBefore(int index)
指定されたインデックスの前の文字(Unicodeコードポイント)を返します。 索引引用char値(Unicodeコード単位)、範囲は1到length。如果
char値で(index - 1)处于低代理项范围,(index - 2)負ではなく、かつchar値で(index - 2)高サロゲート範囲にある場合、サロゲートペアの補助コードポイント値を返します。 如果char値はindex - 1ペアになっていない低サロゲートまたは高サロゲートである場合、サロゲート値を返します。- 参数
-
index返されるコードポイントの後のインデックス - 结果
- 指定されたインデックスの直前のUnicodeコードポイント値。
- 异常
-
IndexOutOfBoundsException- 如果index引数が1未満であるか、この文字列の長さより大きい場合。 - 以下のバージョンから:
- 1.5
-
codePointCount
public int codePointCount(int beginIndex, int endIndex)返回此Stringの指定テキスト範囲内のUnicodeコードポイントの数。 テキスト範囲は指定されたbeginIndex开始,并延伸至char、インデックス番号はendIndex - 1。 したがって、テキスト範囲の長さ(においてchars中)はendIndex-beginIndex。 テキスト範囲内の対になっていないサロゲートは、各コードポイントとしてカウントされます。- 参数
-
beginIndexテキスト範囲の最初charのインデックス。 -
endIndex- テキスト範囲の最後char後のインデックス。 - 结果
- 指定されたテキスト範囲内のUnicodeコードポイント数
- 异常
-
IndexOutOfBoundsException- 如果beginIndex負の場合、またはendIndex大于此Stringの長さ、またはbeginIndex大于endIndex。 - 以下のバージョンから:
- 1.5
-
offsetByCodePoints
public int offsetByCodePoints(int index, int codePointOffset)返回此String内のインデックス、そのインデックスは指定されたindex偏移codePointOffset代码点。 由indexとcodePointOffset指定されたテキスト範囲内のペアになっていないサロゲートは、各コードポイントとして数えられます。- 参数
-
index- オフセットするインデックス -
codePointOffsetコードポイント内のオフセット - 结果
- そのインデックスは
String - 异常
-
IndexOutOfBoundsException- 如果index負であるか、これより大きいStringの長さ、またはもしcodePointOffsetが正でかつ〜からindex始まる部分文字列がcodePointOffsetコードポイント、またはもしcodePointOffset負であり、index前の部分文字列が絶対値より少ないcodePointOffset代码点。 - 以下のバージョンから:
- 1.5
-
getChars
public void getChars(int srcBegin, int srcEnd, char[] dst, int dstBegin)この文字列内の文字を宛先の文字配列にコピーします。コピーされる最初の文字はインデックス
srcBegin; コピーされる最後の文字はインデックスにあります。srcEnd-1(したがって、コピーする文字の総数はsrcEnd-srcBegin)。 文字がコピーされるdstの子dstインデックスからdstBegin开始并以索引结束:dstBegin + (srcEnd-srcBegin) - 1- 参数
-
srcBeginコピーする文字列内の最初の文字のインデックス。 -
srcEndコピーする文字列内の最後の文字の後のインデックス。 -
dst- ターゲット配列。 -
dstBeginターゲット配列内の開始オフセット。 - 异常
-
IndexOutOfBoundsException- 如果满足以下任何条件:-
srcBegin否定のである。 -
srcBegin大于srcEnd -
srcEndこの文字列の長さより大きい -
dstBegin否定のである -
dstBegin+(srcEnd-srcBegin)大于dst.length
-
-
getBytes
@Deprecated(since="1.1") public void getBytes(int srcBegin, int srcEnd, byte[] dst, int dstBegin)
Deprecated.This method does not properly convert characters into bytes. As of JDK 1.1, the preferred way to do this is via thegetBytes()method, which uses the platform's default charset.この文字列の文字をターゲットのバイト配列にコピーします。 各バイトは対応する文字の下位8ビットを受け取ります。 各文字の上位8ビットはコピーされず、いかなる方法でも転送に関としません。コピーされる最初の文字はインデックス
srcBegin; コピーされる最後の文字はインデックスにあります。srcEnd-1。 コピーする文字の総数はsrcEnd-srcBegin。 バイトに変換される文字はコピーされますdstの子dstインデックスからdstBegin开始并以索引结束:dstBegin + (srcEnd-srcBegin) - 1- 参数
-
srcBeginコピーする文字列内の最初の文字のインデックス -
srcEndコピーする文字列内の最後の文字の後のインデックス -
dst- ターゲット配列 -
dstBeginターゲット配列内の開始オフセット - 异常
-
IndexOutOfBoundsException- 如果满足以下任何条件:-
srcBegin否定のである -
srcBegin大于srcEnd -
srcEndこの String の長さより大きい -
dstBegin否定のである -
dstBegin+(srcEnd-srcBegin)大于dst.length
-
-
getBytes
public byte[] getBytes(String charsetName) throws UnsupportedEncodingException
指定された文字セットを使用してこれをStringバイトシーケンスにエンコードし、結果を新しいバイト配列に格納します。この文字列が指定された文字セットでエンコードできない場合の、このメソッドの動作は未指定です。 エンコード・プロセスをより細かく制御する必要がある場合は、次を使用してください。
CharsetEncoder类。- 参数
-
charsetName- サポートされたcharsetの名前 - 结果
- 結果のバイト配列
- 异常
-
UnsupportedEncodingException- 指定されたcharsetがサポートされていない場合 - 以下のバージョンから:
- 1.1
-
getBytes
public byte[] getBytes(Charset charset)
指定されたものを使うcharset将此Stringバイトシーケンスにエンコードし、結果を新しいバイト配列に格納します。このメソッドは、常にこのcharsetのデフォルトの置換バイト配列を使用して、形式が正しくない入力およびマッピングできない文字シーケンスを置換します。 エンコード・プロセスをより細かく制御する必要がある場合は、次を使用してください。
CharsetEncoder类。- 参数
-
charset-该Charsetエンコードに使用されるString - 结果
- 結果のバイト配列
- 以下のバージョンから:
- 1.6
-
getBytes
public byte[] getBytes()
プラットフォームのデフォルト文字セットを使用してこれをStringバイトシーケンスにエンコードし、結果を新しいバイト配列に格納します。この文字列がデフォルト文字セットでエンコードできない場合の、このメソッドの動作は未指定です。 エンコード・プロセスをより細かく制御する必要がある場合は、次を使用してください。
CharsetEncoder类。- 结果
- 結果のバイト配列
- 以下のバージョンから:
- 1.1
-
equals
public boolean equals(Object anObject)
この文字列を指定されたオブジェクトと比較します。 引数が...でない場合に限りnullでありStringオブジェクトがこのオブジェクトと同じ文字シーケンスを表す場合、結果はtrue。より詳細な文字列比較については、次を参照してください
Collator。- 重写:
-
equalsクラス内Object - 参数
-
anObject- 比較Stringのオブジェクト - 结果
-
true指定されたオブジェクトが表す場合Stringこの文字列に相当し、false否则 - 另请参见:
-
compareTo(String),equalsIgnoreCase(String)
-
contentEquals
public boolean contentEquals(StringBuffer sb)
この文字列と指定されたStringBuffer。 その結果はtrue、もし、もしこれが単にString指定されたものと同じ文字シーケンスを表しますStringBuffer。 このメソッドはStringBuffer上同步。より詳細な文字列比較については、次を参照してください
Collator。- 参数
-
sb- 用StringBufferこれを比較するString - 结果
-
true如果此String指定された...を表すStringBuffer同じ文字シーケンス、そうでなければfalse - 以下のバージョンから:
- 1.4
-
contentEquals
public boolean contentEquals(CharSequence cs)
この文字列と指定されたCharSequence。 当且仅当此String指定されたシーケンスと同じchar値シーケンスを表す場合、結果はtrue。 请注意,如果CharSequenceであるStringBufferその場合、このメソッドはそれを同期します。細粒度の文字列比較については、次を参照してください
Collator。- 参数
-
cs- これを比較するStringのシーケンス - 结果
-
true如果此String指定されたシーケンスと同じchar値のシーケンスを表す場合はtrue、それ以外の場合はfalsefalse - 以下のバージョンから:
- 1.5
-
equalsIgnoreCase
public boolean equalsIgnoreCase(String anotherString)
将此String別の...とString大文字と小文字を無視して比較します。 2 つの文字列が同じ長さであり、2 つの文字列内の対応する文字が大文字と小文字を区別せずに等しい場合、それらの文字列は大文字と小文字を区別せずに等しいと見なされます。如果至少满足下列条件之一,则两个字符
c1とc2大文字小文字を無視して同じとみなされます:- 两个字符相同(由
==运营商比较) - 各文字に対して呼び出される
Character.toLowerCase(Character.toUpperCase(char))同じ結果が生成される
请注意,此方法不ロケールの考慮により、特定のロケールでは不満足な結果が生じる場合があります。
Collatorクラスはロケール依存の比較を提供します。- 参数
-
anotherString- 用Stringこれを比較するString比較 - 结果
-
true引数が...でない場合nullそしてそれは等価なものを表すString忽略大小写; それ以外の場合はfalse - 另请参见:
-
equals(Object)
- 两个字符相同(由
-
compareTo
public int compareTo(String anotherString)
按字典顺序比较两个字符串。 比較は、文字列内の各文字のUnicode値に基づきます。 此Stringオブジェクトが表す文字シーケンスが、引数の文字列が表す文字シーケンスと辞書順で比較されます。 如果此Stringオブジェクトが辞書順でパラメータ文字列より前にある場合、結果は負の整数になります。 如果此Stringオブジェクトが辞書順で引数文字列の後に続く場合、結果は正の整数です。 文字列が等しい場合、結果はゼロです;compareToにequals(Object)方法返回0完全返回true。これは辞書式順序の定義です。 2つの文字列が異なる場合、それらは両方の文字列にとって有効なインデックスである位置で異なる文字を持つか、長さが異なるか、またはその両方です。 それらが1つ以上のインデックス位置で異なる文字を持つ場合、k最小のインデックス; 然后,通过使用
<运算符确定其位置kその位置の文字が小さい値を持つ文字列は、辞書順で別の文字列より前に置かれます。 この場合、compareTo返回两个字符串中位置k位置の2つの文字の値のk- 即值:
それらに異なるインデックス位置がない場合、短い方の文字列は辞書順で長い方の文字列の前に置かれます。 この場合、this.charAt(k)-anotherString.charAt(k)
compareTo文字列の長さの差を返します - すなわち値:this.length()-anotherString.length()
より詳細な文字列比較については、次を参照してください
Collator。- Specified by:
-
compareToにComparable<String> - 参数
-
anotherString- 比較対象String。 - 结果
-
如果参数字符串等于此字符串,则值
0; 如果此字符串按字典顺序小于字符串参数,则小于0; 如果此字符串按字典顺序大于字符串参数,则值大于0。
-
compareToIgnoreCase
public int compareToIgnoreCase(String str)
按字典顺序比较两个字符串,忽略大小写差异。 このメソッドは、その符号が呼び出しである整数を返します。compareToの整数。ここで、文字列の正規化バージョンは、各文字に対して呼び出すことによってCharacter.toLowerCase(Character.toUpperCase(character))大文字と小文字の違いをなくします。请注意,此方法不ロケールを考慮すると、特定のロケールでは満足のいかない順序になります。
Collatorクラスはロケール依存の比較を提供します。- 参数
-
str- 比較対象String。 - 结果
- 指定されたStringがこのStringより大きいか、等しいか、小さいかに応じて、負の整数、ゼロ、または正の整数。大文字と小文字の区別を無視します。
- 以下のバージョンから:
- 1.2
- 另请参见:
-
Collator
-
regionMatches
public boolean regionMatches(int toffset, String other, int ooffset, int len)2つの文字列領域が等しいかどうかをテストします。将此
Stringオブジェクトの部分文字列は、パラメータotherの部分文字列と比較されます。 これらの部分文字列が同じ文字シーケンスを表す場合、結果は真です。 比較されるこのStringオブジェクトの部分文字列はインデックスからtoffset開始、長さはlen。 比較対象の他の部分文字列はインデックスからooffset開始、長さはlen。 次の条件の少なくとも1つが満たされる場合に限り、結果はfalse:-
toffset否定のである。 -
ooffset否定のである。 -
toffset+len大于此Stringオブジェクトの長さ。 -
ooffset+len他の引数の長さより大きい。 - 有一些非负整数k小于
len,使得:this.charAt(toffset +k) != other.charAt(ooffset +k)
请注意,此方法不场所考虑。
Collatorクラスはロケール依存の比較を提供します。- 参数
-
toffset- この文字列toffset領域の開始オフセット。 -
other- 文字列パラメータ。 -
ooffset- 文字列パラメータooffset領域の開始オフセット。 -
len比較する文字数。 - 结果
-
trueこの文字列の指定された部分領域が、文字列引数の指定された部分領域と完全に一致する場合; それ以外の場合はfalse。
-
-
regionMatches
public boolean regionMatches(boolean ignoreCase, int toffset, String other, int ooffset, int len)2つの文字列領域が等しいかどうかをテストします。将此
Stringオブジェクトの部分文字列と引数otherの部分文字列に対して行うother。 これらの部分文字列が同じ文字シーケンスを表す場合、結果はtrue,当且仅当ignoreCase真の場合、大文字と小文字を区別しません。 比較されるこのStringオブジェクトの部分文字列はインデックスからtoffset開始、長さはlen。 比較する部分文字列otherインデックスからooffset開始、長さはlen。 結果はfalse当且仅当至少满足下列条件之一时:-
toffset否定のである。 -
ooffset否定のである。 -
toffset+len大于此Stringオブジェクトの長さ。 -
ooffset+len他の引数の長さより大きい。 -
ignoreCaseであるfalse并且有一些非负整数k小于len次のように:this.charAt(toffset+k) != other.charAt(ooffset+k)
-
ignoreCaseであるtrue并且有一些非负整数k小于len次のように:Character.toLowerCase(Character.toUpperCase(this.charAt(toffset+k))) != Character.toLowerCase(Character.toUpperCase(other.charAt(ooffset+k)))
请注意,此方法不ロケールを考慮し、特定のロケールで望ましくない結果をもたらす場合
ignoreCaseためにtrue。Collatorクラスはロケール依存の比較を提供します。- 参数
-
ignoreCase- の場合はtrue、文字を比較するときは、大文字と小文字を無視してください。 -
toffset- この文字列toffset領域の開始オフセット。 -
other- 文字列パラメータ。 -
ooffset- 文字列パラメータooffset領域の開始オフセット。 -
len比較する文字数。 - 结果
-
trueこの文字列の指定された部分領域が、文字列引数の指定された部分領域と一致する場合; それ以外の場合はfalse。 一致が完全一致であるか、大文字小文字を区別しない一致であるかは、以下に依存します。ignoreCase参数。
-
-
startsWith
public boolean startsWith(String prefix, int toffset)
指定されたインデックスから始まるこの文字列の部分文字列が、指定されたプレフィックスで始まるかどうかをテストします。- 参数
-
prefix- 前缀。 -
toffsetこの文字列の検索を開始する位置。 - 结果
-
true引数によって表される文字シーケンスがインデックスtoffsetから始まるこのオブジェクトの部分文字列のプレフィックス; それ以外の場合はfalse。 如果toffset負の値またはこれより大きいStringオブジェクトの長さの場合、結果はfalse; それ以外の場合、結果は式の結果と同じですthis.substring(toffset).startsWith(prefix)
-
startsWith
public boolean startsWith(String prefix)
この文字列が指定されたプレフィックスで始まるかどうかをテストします。- 参数
-
prefix- 前缀。 - 结果
-
true引数によって表される文字シーケンスが、この文字列によって表される文字シーケンスのプレフィックスである場合; それ以外の場合はfalse。 さらに注意すべき点はtrue引数が空文字列またはそれと等しい場合、それが返されます。String例えば測定対象からequals(Object)方法。 - 以下のバージョンから:
- 1.0
-
endsWith
public boolean endsWith(String suffix)
この文字列が指定されたサフィックスで終わるかどうかをテストします。- 参数
-
suffix- 后缀。 - 结果
-
true引数が表す文字シーケンスが、このオブジェクトが表す文字シーケンスの接尾辞である場合; それ以外の場合はfalse。 注意: 結果はtrue引数が空文字列であるか、またはこの文字列と等しい場合Stringによって決定されるオブジェクトのようにequals(Object)方法。
-
hashCode
public int hashCode()
この文字列のハッシュコードを返します。Stringオブジェクトのハッシュコードは次のように計算されます
使用s[0]*31^(n-1) + s[1]*31^(n-2) + ... + s[n-1]
int算术,其中s[i]文字列の第i个字符,n文字列の長さです。^表示取幂。 (空文字列のハッシュ値はゼロです。)- 重写:
-
hashCodeクラス内Object - 结果
- このオブジェクトのハッシュコード値。
- 另请参见:
-
Object.equals(java.lang.Object),System.identityHashCode(java.lang.Object)
-
indexOf
public int indexOf(int ch)
指定された文字が最初に出現する文字列内のインデックスを返します。 この...にある場合Stringオブジェクトが表す文字シーケンス内に出現する値はchその文字が存在する場合、最初の出現位置のインデックスを(Unicodeコード単位で)返します。 0から0xFFFF(両端を含む)の範囲の値に対してch、これは最小値です。k ,使得:
真である。 に対してthis.charAt(k) == ch
ch他の値では、最小値ですk ,使得:
真である。 いずれの場合でも、この文字列にそのような文字が出現しない場合は、返されます。this.codePointAt(k) == ch
-1。- 参数
-
ch- 文字(Unicodeコードポイント)。 - 结果
- このオブジェクトが表す文字シーケンス内で、指定された文字が最初に出現するインデックス。その文字が出現しない場合は、
-1。
-
indexOf
public int indexOf(int ch, int fromIndex)指定された文字がこの文字列内で最初に出現するインデックスを、指定されたインデックスから検索して返します。インデックスが...以上の場合
fromIndex,此Stringオブジェクトが表す文字シーケンス内に出現する値はchの文字の場合は、最初のそのような出現のインデックスを返します。 0から0xFFFF(含む)までの範囲についてはch値。これは最小値k ,使得:
真である。 に対して(this.charAt(k) == ch)
&&(k >= fromIndex)ch他の値では、最小値ですk ,使得:
真である。 いずれの場合でも、位置に(this.codePointAt(k) == ch)
&&(k >= fromIndex)fromIndexそのインデックスまたはその後、その文字列内にそのような文字が出現しない場合は、返します-1。fromIndexの値には制限がありません。 負の値の場合、ゼロと同じ効果があり、文字列全体を検索できます。 それがこの文字列の長さより大きい場合、それはこの文字列の長さと等しい場合と同じ効果を持ちます:返します-1。所有索引都以
char值(Unicode代码单位)指定。- 参数
-
ch- 文字(Unicodeコードポイント)。 -
fromIndex- 検索を開始するインデックス。 - 结果
- このオブジェクトが表す文字シーケンス内で、指定された文字が最初に出現するインデックス(指定されたインデックス以上)。
fromIndex、その文字が出現しない場合は、-1。
-
lastIndexOf
public int lastIndexOf(int ch)
指定された文字が最後に出現する文字列内のインデックスを返します。 範囲が0から0xFFFF(含む)のch值,chインデックス(Unicodeコード単位)は最大値ですk,次のように:
真である。 に対してthis.charAt(k) == ch
ch他の値では、最大値ですk ,使得:
真である。 いずれの場合でも、この文字列にそのような文字が出現しない場合は、返されます。this.codePointAt(k) == ch
-1。 最後の文字から後方に検索しますString。- 参数
-
ch- 文字(Unicodeコードポイント)。 - 结果
- このオブジェクトが表す文字シーケンス内で、指定された文字が最後に出現するインデックス。その文字が出現しない場合は、
-1。
-
lastIndexOf
public int lastIndexOf(int ch, int fromIndex)指定された文字が最後に出現する文字列内のインデックスを返し、指定されたインデックスから後方に検索します。 範囲が0から0xFFFF(含む)のch値の場合、返されるインデックスは最大値k ,使得:
真である。 に対して(this.charAt(k) == ch)
&&(k <= fromIndex)ch他の値では、最大値ですk ,使得:
真である。 いずれの場合でも、位置に(this.codePointAt(k) == ch)
&&(k <= fromIndex)fromIndex处或之前此字符串中没有出现此类字符,则返回-1。所有索引都以
char值(Unicode代码单位)指定。- 参数
-
ch- 1つの文字(Unicodeコードポイント)。 -
fromIndex- 検索を開始するインデックス。fromIndexの値には制限がありません。 その値が文字列の長さ以上の場合、文字列の長さより 1 小さい値に等しい場合と同じ効果になります:文字列全体を検索できます。 それが負の数である場合、-1と同じ効果があります。-1を返します。 - 结果
- このオブジェクトが表す文字シーケンス内で、指定された文字が最後に出現するインデックス(指定されたインデックス以下)。
fromIndex、その時点以前にその文字が出現しない場合-1。
-
indexOf
public int indexOf(String str)
指定された部分文字列が最初に出現する文字列内のインデックスを返します。返されるインデックスは最小値です
k,其中:そのような値がない場合this.startsWith(str, k)k存在するならば、-1返回。- 参数
-
str- 検索する部分文字列。 - 结果
- 指定された部分文字列が最初に出現するインデックス。そのような出現がない場合は、
-1。
-
indexOf
public int indexOf(String str, int fromIndex)
指定されたインデックスから開始して、指定された部分文字列が最初に出現する文字列内のインデックスを返します。返されるインデックスは最小値です
k,其中:そのような値がない場合k >= Math.min(fromIndex, this.length()) && this.startsWith(str, k)k存在するならば、-1返回。- 参数
-
str- 検索する部分文字列。 -
fromIndex- 検索を開始するインデックス。 - 结果
- 指定されたインデックスから検索を開始した場合の、指定された部分文字列が最初に出現するインデックス。そのような出現がない場合は
-1。
-
lastIndexOf
public int lastIndexOf(String str)
指定された部分文字列が最後に出現する文字列内のインデックスを返します。 空文字列“”の最後の出現は、インデックス値において発生するとみなされます。this.length()。返されるインデックスは最大値です
k,其中:そのような値がない場合this.startsWith(str, k)k存在するならば、-1返回。- 参数
-
str- 検索する部分文字列。 - 结果
- 指定された部分文字列が最後に出現するインデックス。そのような出現がない場合は、
-1。
-
lastIndexOf
public int lastIndexOf(String str, int fromIndex)
指定された部分文字列が最後に出現する文字列内のインデックスを、指定されたインデックスから後方に検索して返します。返されるインデックスは最大値です
k,其中:そのような値がない場合k <= Math.min(fromIndex, this.length()) && this.startsWith(str, k)k存在するならば、-1返回。- 参数
-
str- 検索する部分文字列。 -
fromIndex- 検索を開始するインデックス。 - 结果
- 指定された部分文字列が最後に出現するインデックス。指定されたインデックスから後方に検索し、そのような出現がない場合は
-1。
-
substring
public String substring(int beginIndex)
この文字列の部分文字列である文字列を返します。 部分文字列は、指定されたインデックスの文字で始まり、この文字列の末尾まで続きます。例子:
"unhappy".substring(2) returns "happy" "Harbison".substring(3) returns "bison" "emptiness".substring(9) returns "" (an empty string)
- 参数
-
beginIndex開始インデックス(含む)。 - 结果
- 指定された部分文字列。
- 异常
-
IndexOutOfBoundsException- 如果beginIndex負であるか、これより大きいStringオブジェクトの長さ。
-
substring
public String substring(int beginIndex, int endIndex)
この文字列の部分文字列である文字列を返します。 指定されたインデックスからの部分文字列beginIndex开始,并扩展到索引endIndex - 1にある文字。 したがって、部分文字列の長さはendIndex-beginIndex。例子:
"hamburger".substring(4, 8) returns "urge" "smiles".substring(1, 5) returns "mile"
- 参数
-
beginIndex開始インデックス(含む)。 -
endIndex終了インデックス(含まない)。 - 结果
- 指定された部分文字列。
- 异常
-
IndexOutOfBoundsException- 如果beginIndex負の場合、またはendIndex大于此Stringオブジェクトの長さ、またはbeginIndex大于endIndex。
-
subSequence
public CharSequence subSequence(int beginIndex, int endIndex)
このシーケンスの部分シーケンスである文字シーケンスを返します。このメソッドを呼び出す形式
動作は呼び出しと完全に同じですstr.subSequence(begin, end)
str.substring(begin, end)
- Specified by:
-
subSequenceインターフェースでCharSequence - API Note:
-
定义此方法,以便
String类可以实现CharSequence接口。 - 参数
-
beginIndex- 開始インデックスを含む。 -
endIndex終了インデックス(含まない)。 - 结果
- 指定された部分シーケンス。
- 异常
-
IndexOutOfBoundsException- 如果beginIndex或endIndex負の場合、endIndex大于length(),或者beginIndex大于endIndex - 以下のバージョンから:
- 1.4
-
concat
public String concat(String str)
指定された文字列をこの文字列の末尾に連結します。引数文字列の長さが
0,则返回此Stringオブジェクト。 否则,返回一个Stringこのオブジェクトは、この文字列によって構成される文字シーケンスを表します。Stringオブジェクトによって表される文字シーケンスと、引数文字列によって表される文字シーケンスとの連結。例子:
"cares".concat("s") returns "caress" "to".concat("get").concat("her") returns "together"- 参数
-
str-该Stringこの文字列の末尾に連結されるString。 - 结果
- このオブジェクトの文字列と、文字列引数の文字を連結したものを表す文字列。
-
replace
public String replace(char oldChar, char newChar)
すべての出現箇所を置換した結果の文字列を返します。oldCharこの文字列ではnewChar。如果字符
oldCharこのオブジェクトが表す文字シーケンス内では発生しないStringオブジェクトの場合、その基準Stringオブジェクトが返されます。 否则,String返されるオブジェクトは、ある文字シーケンスと、これによって表される文字シーケンスを表します。Stringオブジェクトの各出現を除いて、oldCharの出現箇所を置き換えることによってnewChar。例子:
"mesquite in your cellar".replace('e', 'o') returns "mosquito in your collar" "the war of baronets".replace('r', 'y') returns "the way of bayonets" "sparring with a purple porpoise".replace('p', 't') returns "starring with a turtle tortoise" "JonL".replace('q', 'x') returns "JonL" (no change)- 参数
-
oldChar- 旧文字。 -
newChar- 新しい文字。 - 结果
-
通过将
oldChar各一致項目を...に置き換えるoldChar,newChar文字列から派生した文字列。
-
matches
public boolean matches(String regex)
この文字列が指定されたものと等しいかどうかを判断するregular expression匹配。调用str
.matches(regex)この形式のメソッドは、...と同じ結果を生成します。表达式まったく同じ結果Pattern.matches(regex, str)- 参数
-
regex- この文字列と照合する正規表現 - 结果
-
trueこの文字列が指定された正規表現と一致する場合に限りtrue - 异常
-
PatternSyntaxException正規表現の構文が無効な場合 - 以下のバージョンから:
- 1.4
- 另请参见:
-
Pattern
-
contains
public boolean contains(CharSequence s)
この文字列が指定されたchar値のシーケンスを含む場合に限り、trueを返します。- 参数
-
s- 検索するシーケンス - 结果
- この文字列が含む場合
s、その場合はtrueを返し、そうでなければsfalse - 以下のバージョンから:
- 1.5
-
replaceFirst
public String replaceFirst(String regex, String replacement)
指定された置換で指定されたregular expressionこの文字列の一致する最初の部分文字列を置換します。调用str
.replaceFirst(このメソッドの形式regex,repl)式とまったく同じ結果を生成しますPattern.compile(regex).matcher(str).replaceFirst(repl)置換文字列内のバックスラッシュに注意してください(
\)とドル記号($)をリテラル置換文字列として扱った場合の結果とは異なる結果になる場合があります。 见Matcher.replaceFirst(java.lang.String)。 如果需要,请使用Matcher.quoteReplacement(java.lang.String)これらの文字の特別な意味を抑制するために。- 参数
-
regex- この文字列と照合する正規表現 -
replacement- 最初の一致項目を置き換える文字列 - 结果
- これにより生じる
String - 异常
-
PatternSyntaxException正規表現の構文が無効な場合 - 以下のバージョンから:
- 1.4
- 另请参见:
-
Pattern
-
replaceAll
public String replaceAll(String regex, String replacement)
指定された置換で指定されたregular expression一致したこの文字列の各部分文字列を置換します。调用str
.replaceAll(このメソッドの形式regex,repl)式とまったく同じ結果を生成しますPattern.compile(regex).matcher(str).replaceAll(repl)置換文字列内のバックスラッシュに注意してください(
\)とドル記号($)は、それをリテラル置換文字列として扱った場合と結果が異なる場合があります; 见Matcher.replaceAll。 如果需要,请使用Matcher.quoteReplacement(java.lang.String)これらの文字の特別な意味を抑制するために。- 参数
-
regex- この文字列と照合する正規表現 -
replacement各一致を置換する文字列 - 结果
- これにより生じる
String - 异常
-
PatternSyntaxException正規表現の構文が無効な場合 - 以下のバージョンから:
- 1.4
- 另请参见:
-
Pattern
-
replace
public String replace(CharSequence target, CharSequence replacement)
この文字列内のリテラルターゲットシーケンスに一致する各部分文字列を、指定されたリテラル置換シーケンスに置き換えます。 置換は文字列の先頭から末尾まで行われます。たとえば、文字列「aaa」内の「aa」を「b」に置換すると、「ba」になり、「ab」にはなりません。- 参数
-
target- 置換対象のchar値のシーケンス -
replacement- char値の置換シーケンス - 结果
- 结果字符串
- 以下のバージョンから:
- 1.5
-
split
public String[] split(String regex, int limit)
この文字列を指定された正規表現の匹配项 。このメソッドが返す配列には、この文字列の各部分文字列が含まれます。各部分文字列は、指定された式に一致する別の部分文字列、または文字列の末尾によって終了します。 配列内の部分文字列は、この文字列内で出現する順に並べられます。 式が入力のどの部分にも一致しない場合、結果の配列にはその文字列だけの1つの要素のみが含まれます。
この文字列の先頭に正の幅の一致がある場合、結果の配列の先頭に空の先頭部分文字列が含まれます。 ただし、先頭のゼロ幅マッチは、そのような空の先行部分文字列を生成することは決してありません。
limitパラメータはパターンを適用する回数を制御するため、結果の配列の長さに影響します。如果限制が正の場合、パターンは最大で適用されます限制- 1回、配列の長さは超えません。限制、配列の最後の要素には、最後に一致した区切り文字より後のすべての入力が含まれます。
如果限制ゼロの場合、パターンは可能な限り適用され、配列は任意の長さを持つことができ、末尾の空文字列は破棄されます。
如果限制負の場合、パターンは可能な限り多く適用され、配列は任意の長さを持つことができます。
例如,字符串
"boo:and:foo"使用以下参数生成以下结果:Regex Limit Result : 2 { "boo", "and:foo" }5 { "boo", "and", "foo" }-2 { "boo", "and", "foo" }o 5 { "b", "", ":and:f", "", "" }-2 { "b", "", ":and:f", "", "" }0 { "b", "", ":and:f" }调用strこの形式のメソッド。
split(regex,n)式と同じ結果を生成しますPattern.compile(regex).split(str, n)- 参数
-
regex- 区切り正規表現 -
limit- 前述の結果のしきい値 - 结果
- 指定された正規表現の一致箇所の周囲でこの文字列を分割して計算された文字列配列
- 异常
-
PatternSyntaxException正規表現の構文が無効な場合 - 以下のバージョンから:
- 1.4
- 另请参见:
-
Pattern
-
split
public String[] split(String regex)
この文字列を指定された正規表現の匹配项 。このメソッドは、指定された式とlimit引数がゼロの2引数メソッドを呼び出したかのように動作します。
split方法一样。 したがって、末尾の空文字列は結果の配列に含まれません。例如,字符串
"boo:and:foo"使用以下表达式产生以下结果:Regex Result : { "boo", "and", "foo" }o { "b", "", ":and:f" }- 参数
-
regex- 区切り正規表現 - 结果
- 指定された正規表現の一致箇所の周囲でこの文字列を分割して計算された文字列配列
- 异常
-
PatternSyntaxException正規表現の構文が無効な場合 - 以下のバージョンから:
- 1.4
- 另请参见:
-
Pattern
-
join
public static String join(CharSequence delimiter, CharSequence... elements)
返回由CharSequence elementsのコピーから構成される新しいString、そのコピーと指定されたdelimiterのコピーを連結します。For example,
注意:要素がnullの場合は追加されます。String message = String.join("-", "Java", "is", "cool"); // message returned is: "Java-is-cool""null"。- 参数
-
delimiter各要素を区切る区切り文字 -
elements一緒に連結する要素。 - 结果
- 新しい
String、前述の...によってelements由分离delimiter - 异常
-
NullPointerException- 如果delimiter或elementsであるnull - 以下のバージョンから:
- 1.8
- 另请参见:
-
StringJoiner
-
join
public static String join(CharSequence delimiter, Iterable<? extends CharSequence> elements)
返回由Stringのコピーで構成される新しいString,其中CharSequence elements指定されたdelimiterのコピー。For example,
単一の要素である場合は注意してくださいList<String> strings = List.of("Java", "is", "cool"); String message = String.join(" ", strings); //message returned is: "Java is cool" Set<String> strings = new LinkedHashSet<>(List.of("Java", "is", "very", "cool")); String message = String.join("-", strings); //message returned is: "Java-is-very-cool"null,则添加"null"。- 参数
-
delimiter- 各要素を区切るために使用される文字シーケンスelements得られたString -
elements-Iterable将其elements連結されている。 - 结果
-
由
elementsパラメータで構成される新しいString - 异常
-
NullPointerException- 如果delimiter或elementsであるnull - 以下のバージョンから:
- 1.8
- 另请参见:
-
join(CharSequence,CharSequence...),StringJoiner
-
toLowerCase
public String toLowerCase(Locale locale)
使用给定Localeの規則はこれをStringすべての文字を変換するLocale。 案例映射基于Characterクラスで指定されたUnicode標準のバージョン。 大文字と小文字のマッピングは常に1:1の文字マッピングであるとは限らないため、結果のString元のものと異なる可能性があるString长度不同。小文字マッピングの例を以下の表に示します。
Lowercase mapping examples showing language code of locale, upper case, lower case, and description Language Code of Locale Upper Case Lower Case Description tr (Turkish) \u0130 \u0069 capital letter I with dot above -> small letter i tr (Turkish) \u0049 \u0131 capital letter I -> small letter dotless i (all) French Fries french fries lowercased all chars in String (all) ΙΧΘΥΣ ιχθυσ lowercased all chars in String- 参数
-
locale- このロケールの大文字小文字変換ルールを使用する - 结果
-
String、小文字に変換される。 - 以下のバージョンから:
- 1.1
- 另请参见:
-
toLowerCase(),toUpperCase(),toUpperCase(Locale)
-
toLowerCase
public String toLowerCase()
デフォルトのロケールの規則を使用して、この...Stringすべての文字を小文字に変換します。 これは呼び出しに相当します。toLowerCase(Locale.getDefault())。注意:このメソッドはロケールに依存します。ロケールから独立して解釈されるべき文字列に使用すると、予期しない結果が生じる可能性があります。 例としては、プログラミング言語の識別子、プロトコルキー、HTMLタグです。 例如,
"TITLE".toLowerCase()トルコのロケールでは返します"t\u0131tle"、ここで、“\u0131”はラテン小文字のドットなしi文字です。 ロケール非依存の文字列の正しい結果を取得するには、を使用してくださいtoLowerCase(Locale.ROOT)。- 结果
-
String、小文字に変換される。 - 另请参见:
-
toLowerCase(Locale)
-
toUpperCase
public String toUpperCase(Locale locale)
使用给定Localeの規則はこれをStringすべての文字を大文字に変換します。 案例映射基于Characterクラスで指定されたUnicode標準のバージョン。 大文字と小文字のマッピングは常に1:1の文字マッピングであるとは限らないため、生成されたString元のものと異なる可能性があるString长度不同。ロケール依存および1:Mケースマッピングの例を次の表に示します。
Examples of locale-sensitive and 1:M case mappings. Shows Language code of locale, lower case, upper case, and description. Language Code of Locale Lower Case Upper Case Description tr (Turkish) \u0069 \u0130 small letter i -> capital letter I with dot above tr (Turkish) \u0131 \u0049 small letter dotless i -> capital letter I (all) \u00df \u0053 \u0053 small letter sharp s -> two letters: SS (all) Fahrvergnügen FAHRVERGNÜGEN- 参数
-
locale- このロケールの大文字小文字変換ルールを使用する - 结果
-
String、大文字に変換される。 - 以下のバージョンから:
- 1.1
- 另请参见:
-
toUpperCase(),toLowerCase(),toLowerCase(Locale)
-
toUpperCase
public String toUpperCase()
デフォルトのロケールの規則を使用して、この...Stringすべての文字を大文字に変換します。 此方法相当于toUpperCase(Locale.getDefault())。注意:このメソッドはロケールに依存します。ロケールから独立して解釈されるべき文字列に使用すると、予期しない結果が生じる可能性があります。 例としては、プログラミング言語の識別子、プロトコルキー、HTMLタグです。 例如,
"title".toUpperCase()トルコのロケールでは返します"T\u0130TLE"、ここで「\ u0130」は上に点を持つラテン大文字のIです。 ロケール非依存の文字列の正しい結果を取得するには、を使用してくださいtoUpperCase(Locale.ROOT)。- 结果
-
String、大文字に変換される。 - 另请参见:
-
toUpperCase(Locale)
-
trim
public String trim()
文字列を返します。その値は、すべての先頭および末尾の空白を削除したこの文字列です。ここで、spaceはコードポイントが...以下であるものとして定義されます。'U+0020'(空白文字)の任意の文字。如果此
Stringオブジェクトが空の文字シーケンスを表すか、またはその表す文字シーケンスの最初と最後の文字で。Stringオブジェクトはすべて、上記定義のスペースではないコードを持ち、そしてその基準Stringオブジェクトが返されます。それ以外の場合、この文字列内のすべての文字が空白(上記のとおり)である場合、空文字列を表す
Stringオブジェクト。否则,令k文字列内の最初の文字のインデックスであり、その文字のコードが空白(上記で定義)ではない。そして、m文字列内の最後の文字のインデックスであり、その文字のコードはスペースではない(上記で定義された通り)。 返回一个
Stringオブジェクト。この文字列の部分文字列を表し、その文字列はインデックスkの文字で始まり、インデックスでmの位置の文字で終了し、すなわちthis.substring(k, m + 1)の結果。このメソッドは、文字列の先頭と末尾からスペースをトリミングするために使用できます(上記の通り)。
- 结果
- この文字列を値として持ち、先頭と末尾のすべての空白が削除された文字列。先頭または末尾の空白がない場合は、この文字列。
-
strip
public String strip()
この文字列を値とし、先頭と末尾のすべての空白を削除した文字列を返します。white space。如果此
Stringオブジェクトは空文字列を表すか、この文字列内のすべてのコードポイントがwhite space,则返回空字符串。そうでない場合、この文字列の部分文字列を返します。その部分文字列は、最初の非...から始まります。
white spaceのコードポイントの先頭、最後のものは含まれません。white spaceの代码点。このメソッドは、文字列の先頭と末尾から取り除くために使用できます。
white space。- 结果
- この文字列を値として持ち、先頭と末尾のすべての空白が削除された文字列。
- 以下のバージョンから:
- 11
- 另请参见:
-
Character.isWhitespace(int)
-
stripLeading
public String stripLeading()
先頭にあるすべてのものを削除した、この文字列を値として持つ文字列を返します。white space。如果此
Stringオブジェクトは空文字列を表すか、この文字列内のすべてのコードポイントがwhite space,则返回空字符串。そうでない場合、この文字列の部分文字列を返します。その部分文字列は、最初の非...から始まります。
white spaceのコードポイントで始まり、その文字列の最後のコードポイントを含みます。このメソッドは、文字列の先頭からトリムするために使用できます
white space。- 结果
- この文字列を値として持ち、先頭のすべての空白が削除された文字列。
- 以下のバージョンから:
- 11
- 另请参见:
-
Character.isWhitespace(int)
-
stripTrailing
public String stripTrailing()
この文字列を値とし、すべての末尾を削除した文字列を返します。white space。如果此
Stringオブジェクトは空文字列を表すか、またはこの文字列内のすべての文字がwhite space,则返回空字符串。それ以外の場合、この文字列の最初のコードポイントで始まり、最後の...ではないコードポイントを含む、この文字列の部分文字列を返します。
white spaceの代码点。このメソッドは、文字列の末尾をトリミングするために使用できます。
white space。- 结果
- この文字列を値として持ち、末尾のすべての空白が削除された文字列。
- 以下のバージョンから:
- 11
- 另请参见:
-
Character.isWhitespace(int)
-
isBlank
public boolean isBlank()
- 结果
-
true文字列が空であるか、またはのみを含む場合white spaceコードポイント、それ以外の場合はfalse - 以下のバージョンから:
- 11
- 另请参见:
-
Character.isWhitespace(int)
-
lines
public Stream<String> lines()
この文字列から抽出された行のストリームを、行終端文字で区切って返します。行结束符以下のいずれかです:改行文字
"\n"(U + 000A),回车字符"\r"(U + 000D),或回车换行符紧跟"\r\n"(U + 000D U + 000A) 。一行ゼロ個以上の文字のシーケンスの後に行終端子が続くもの、または1個以上の文字のシーケンスの後に文字列の終わりが続くものです。 一行不包括行终止符。
このメソッドが返すストリームには、この文字列内に出現する行が含まれます。
- API Note:
- この行の定義により、空の文字列は0行を持ち、文字列の末尾にある行終端文字の後には空の行はありません。
- Implementation Note:
- 要素を遅延的に提供し、新しい行終端文字をより速く検索することにより、このメソッドは split("\R") よりも優れたパフォーマンスを提供します。
- 结果
- この文字列から抽出された行のストリーム
- 以下のバージョンから:
- 11
-
toString
public String toString()
このオブジェクト(すでに文字列です!)自体が返されます。- Specified by:
-
toStringインターフェースでCharSequence - 重写:
-
toStringクラス内Object - 结果
- 文字列自体。
-
chars
public IntStream chars()
返回intのストリームは、このシーケンス内のchar值进行零扩展。 映射到サロゲートコードポイントのいかなる文字も解釈されません。- Specified by:
-
charsインターフェースでCharSequence - 结果
- このシーケンスのchar値のIntStream
- 以下のバージョンから:
- 9
-
codePoints
public IntStream codePoints()
このシーケンス内のコードポイント値のストリームを返します。 シーケンス内で遭遇した任意のサロゲートペアは、あたかも結合されCharacter.toCodePoint一样 ,结果传递给流。 その他のすべてのコード単位(通常のBMP文字、対にならないサロゲート、未定義のコード単位を含む)はゼロ拡張されてint值,然后传递给流。- Specified by:
-
codePointsインターフェースでCharSequence - 结果
- このシーケンスのUnicodeコードポイントのIntStream
- 以下のバージョンから:
- 9
-
toCharArray
public char[] toCharArray()
この文字列を新しい文字配列に変換します。- 结果
- 新しく割り当てられた文字配列。その長さはこの文字列の長さであり、その内容はこの文字列が表す文字シーケンスを含むように初期化されます。
-
format
public static String format(String format, Object... args)
指定された書式文字列と引数を使用して、フォーマットされた文字列を返します。常に使用されるロケールは
Locale.getDefault(Locale.Category)返されるロケール、その中で指定されたFORMAT类别。- 参数
-
format- A format string -
args- 書式文字列内の書式指定子によって参照される引数。 如果参数多于格式说明符,则忽略额外参数。 パラメータの数は可変で、ゼロにすることができます。 パラメータの最大数は...に制限されるThe Java™ Virtual Machine Specification定義されたJava配列の最大次元数の制限。nullパラメータの動作は...に依存するconversion 。 - 结果
- フォーマットされた文字列
- 异常
-
IllegalFormatException- 書式文字列に不正な構文が含まれている場合、書式指定子が指定された引数と互換性がない場合、指定された書式文字列の引数が不足している場合、またはその他の不正な条件の場合。 考えられるすべての形式エラーの説明については、formatterクラスの仕様を参照してください。Details部分。 - 以下のバージョンから:
- 1.5
- 另请参见:
-
Formatter
-
format
public static String format(Locale l, String format, Object... args)
指定されたロケール、書式文字列、および引数を使用して、書式付き文字列を返します。- 参数
-
l- フォーマット時に適用されるlocale 。 如果lであるnull则不应用本地化。 -
format- A format string -
args- 書式文字列内の書式指定子によって参照される引数。 如果参数多于格式说明符,则忽略额外参数。 パラメータの数は可変で、ゼロにすることができます。 パラメータの最大数は...に制限されるThe Java™ Virtual Machine Specification定義されたJava配列の最大次元数の制限。nullパラメータに対する動作は、...に依存しますconversion 。 - 结果
- フォーマットされた文字列
- 异常
-
IllegalFormatException- 書式文字列に不正な構文が含まれている場合、書式指定子が指定された引数と互換性がない場合、指定された書式文字列の引数が不足している場合、またはその他の不正な条件の場合。 考えられるすべての形式エラーの説明については、formatterクラスの仕様を参照してください。Details部分 - 以下のバージョンから:
- 1.5
- 另请参见:
-
Formatter
-
valueOf
public static String valueOf(Object obj)
返回Object引数の文字列表現。- 参数
-
obj-Object。 - 结果
-
パラメータが...の場合
null,则字符串等于"null"; 否则,返回值obj.toString()。 - 另请参见:
-
Object.toString()
-
valueOf
public static String valueOf(char[] data)
返回char配列引数の文字列表現。 文字配列の内容をコピーします; 後続の文字配列の変更は、返された文字列には影響しません。- 参数
-
data- 文字配列。 - 结果
-
a
String、文字配列の文字を含む。
-
valueOf
public static String valueOf(char[] data, int offset, int count)
返回char配列引数の特定のサブ配列の文字列表現。offsetパラメータは部分offset最初の文字のインデックス。count参数指定子countの長さ。 サブ配列の内容をコピーします; 後続の文字配列の変更は、返された文字列には影響しません。- 参数
-
data- 文字配列。 -
offsetサブ配列の初期オフセット。 -
count- サブ配列の長さ。 - 结果
-
a
String文字配列の指定された部分配列の文字を含む。 - 异常
-
IndexOutOfBoundsException- 如果offset負の場合、またはcount負の場合、またはoffset+count大于data.length。
-
copyValueOf
public static String copyValueOf(char[] data, int offset, int count)
- 参数
-
data- 文字配列。 -
offsetサブ配列の初期オフセット。 -
count- サブ配列の長さ。 - 结果
-
a
String文字配列の指定された部分配列の文字を含む。 - 异常
-
IndexOutOfBoundsException- 如果offset負の場合、またはcount負の場合、またはoffset+count大于data.length。
-
copyValueOf
public static String copyValueOf(char[] data)
相当于valueOf(char[])。- 参数
-
data- 文字配列。 - 结果
- 文字配列の文字を含む
String。
-
valueOf
public static String valueOf(boolean b)
返回boolean引数の文字列表現。- 参数
-
b- aboolean。 - 结果
-
引数が...の場合
true,则返回等于"true"の文字列; 否则,返回等于"false"の文字列。
-
valueOf
public static String valueOf(char c)
返回char引数の文字列表現。- 参数
-
c- achar。 - 结果
- 長さが...の
1の文字列、1包含参数cその単一の文字として。
-
valueOf
public static String valueOf(int i)
返回int引数の文字列表現。この表現形式は、まさに1つの引数の
Integer.toStringメソッドによって返される表現。- 参数
-
i-int。 - 结果
-
intパラメータの文字列表現。 - 另请参见:
-
Integer.toString(int, int)
-
valueOf
public static String valueOf(long l)
返回long引数の文字列表現。その表現はちょうど1つの引数の
Long.toStringメソッドが返す表現。- 参数
-
l- along。 - 结果
-
longパラメータの文字列表現。 - 另请参见:
-
Long.toString(long)
-
valueOf
public static String valueOf(float f)
返回float引数の文字列表現。その表現はちょうど1つの引数の
Float.toStringメソッドが返す表現。- 参数
-
f- afloat。 - 结果
-
floatパラメータの文字列表現。 - 另请参见:
-
Float.toString(float)
-
valueOf
public static String valueOf(double d)
返回double引数の文字列表現。その表現はちょうど1つの引数の
Double.toStringメソッドが返す表現。- 参数
-
d- adouble。 - 结果
-
doubleパラメータの文字列表現。 - 另请参见:
-
Double.toString(double)
-
intern
public String intern()
文字列オブジェクトの標準表現を返します。最初は空の文字列プールはクラスによって
String私有维护。调用实习方法时,如果池已包含等于Stringメソッドによって決定される
Stringオブジェクトの文字列の場合、プール内の文字列を返します。 否则,将此Stringオブジェクトはプールに追加され、これへの参照が返されますStringオブジェクトの参照。したがって、任意の2つの文字列について
sとt,s.intern() == t.intern()であるtrue当且仅当s.equals(t)ためにtrue。すべての文字列リテラルと文字列値の定数式はエンティティです。 文字列リテラルはThe Java™ Language Specificationの 3.10.5节中定义。
- 结果
- この文字列と同じ内容の文字列ですが、一意の文字列プールから取得されることが保証されています。
- See The Java™ Language Specification:
- 3.10.5 文字列リテラル
-
repeat
public String repeat(int count)
その値がこの文字列の連結繰り返しである文字列を返します。count次。この文字列が空であるかcountがゼロの場合、空文字列を返します。
- 参数
-
count- 繰り返し回数 - 结果
- この文字列で構成される文字列の繰り返し
count回。この文字列が空であるかcountがゼロの場合、空文字列です。 - 异常
-
IllegalArgumentException- 如果count負の数である。 - 以下のバージョンから:
- 11
-
-