Java(SE) API 逆引き辞典

java.lang.StringBuffer
Pb StringBuffer insert(int i, String s)

対象の文字列バッファのインデックス i に文字列 s を挿入します。
インデックス i 以降の文字列は、後ろにずれます。

インデックス i には、「 0 〜 文字列バッファの文字数 」の値を指定できます。

文字列 s が null の場合は、"null" を挿入します。

●引数

i … 挿入するインデックス
s … 挿入する文字列

●戻り値

文字列 s を挿入した文字列バッファ

●例外

・StringIndexOutOfBoundsException

インデックス i が範囲外の場合

java.lang.StringBuffer
Pb StringBuffer insert(int i, boolean v)
Pb StringBuffer insert(int i, char v)
Pb StringBuffer insert(int i, double v)
Pb StringBuffer insert(int i, float v)
Pb StringBuffer insert(int i, int v)
Pb StringBuffer insert(int i, long v)

対象の文字列バッファのインデックス i に値 v を挿入します。
インデックス i 以降の文字列は、後ろにずれます。

インデックス i には、「 0 〜 文字列バッファの文字数 」の値を指定できます。

挿入の際、値 v は文字列に変換されます。

●引数

i … 挿入するインデックス
v … 挿入する値

●戻り値

値 v の文字列を挿入した文字列バッファ

●例外

・StringIndexOutOfBoundsException

インデックス i が範囲外の場合

java.lang.StringBuffer
Pb StringBuffer insert(int i, Object o)

対象の文字列バッファのインデックス i にオブジェクト o を挿入します。
インデックス i 以降の文字列は、後ろにずれます。

インデックス i には、「 0 〜 文字列バッファの文字数 」の値を指定できます。

オブジェクト o が null の場合は、"null" を挿入します。
null でなければ、o.toString() の戻り値と同じ文字列を挿入します。

●引数

i … 挿入するインデックス
o … 挿入するオブジェクト

●戻り値

オブジェクト o の文字列を挿入した文字列バッファ

●例外

・StringIndexOutOfBoundsException

インデックス i が範囲外の場合

java.lang.StringBuffer
Pb StringBuffer insert(int i, char[] a)
Pb StringBuffer insert(int i, char[] a, int si, int sz)

対象の文字列バッファのインデックス i に文字配列 a を挿入します。
インデックス i 以降の文字列は、後ろにずれます。

インデックス i には、「 0 〜 文字列バッファの文字数 」の値を指定できます。

挿入の際、文字配列 a は文字列に変換されます。

開始インデックス si と文字数 sz を調整することで、文字配列の一部分を挿入できます。

●引数

i … 挿入するインデックス
a … 挿入する文字配列
si … 文字配列 a の開始インデックス
sz … 挿入する文字数

●戻り値

文字配列 a の文字列を挿入した文字列バッファ

●例外

・NullPointerException

文字配列 a が null の場合

・StringIndexOutOfBoundsException

(1) インデックス i が範囲外の場合

(2) 開始インデックス si がマイナスの場合

(3) 文字数 sz がマイナスの場合

(4) si + sz が a.length より大きい場合

●戻り値

挿入の際、文字配列の内容はコピーされます。 そのため、挿入後に文字配列の内容を変更しても、挿入した文字列バッファには影響しません。

挿入する場所の文字列がわかっている場合は、String クラスの indexOf メソッドでそのインデックスを求めることができます。

String str = "StringBuffer クラスのメソッド";
String insData = " insert ";

// 挿入するインデックスを求める
String search = "メソッド";
int index = str.indexOf(search);

StringBuffer sb = new StringBuffer(str);
sb.insert(index, insData);

String strnew = sb.toString();

ソースファイル

strnew は "StringBuffer クラスの insert メソッド" になります。

• ▽ String.indexOf はこちら
• 文字列を前から検索する