replace メソッド

stringObj.replace(rgExp, replaceText)

引数

stringObj: 必ず指定します。置換処理の対象となる String オブジェクトの名前または文字列リテラルを指定します。
この文字列は、replace メソッドにより変更されません。
rgExp: 必ず指定します。正規表現パターンおよび適用できるフラグを含む Regular Expression オブジェクトのインスタンスを指定します。
String オブジェクトの名前またはリテラルを指定することもできます。
rgExp が Regular Expression オブジェクトのインスタンスでない場合は文字列に変換され、完全に一致する文字列の検索が実行されます。
文字列から正規表現への変換は行われません。
replaceText: 必ず指定します。検索で見つかった部分を置換するテキストが入った String オブジェクトまたは文字列リテラルを指定します。
JScript 5.5 以降では、置換するテキストを返す関数を指定することもできます。

解説

正規表現または検索文字列を使って置換された文字列のコピーを返します。
戻り値は、指定された置換を終えた後の stringObj のコピーを返します。

サンプルソース

var str = "ABCDEABCDE";
s1 = str.replace(/B/,"X");  // s1は"AXCDEABCDE"
s2 = str.replace(/B/g,"X"); // s2は"AXCDEAXCDE"

関連する内容

charAt・・・指定されたインデックス番号の位置にある文字を返します。
charCodeAt・・・指定した位置にある文字の Unicode コードを整数値で返します。
fromCharCode・・・Unicode のコード値から文字列を作成します。
indexOf・・・String オブジェクト (文字列) 内を、指定された文字列で先頭から検索します。
lastIndexOf・・・String オブジェクト (文字列) 内を、指定された検索文字列で後方から検索します。
match・・・正規表現パターンを使って文字列に対して検索を実行し、検索結果を含む配列を返します。
replace・・・正規表現または検索文字列を使って置換された文字列のコピーを返します。
search・・・正規表現に一致する最初の文字列の位置を返します。
slice・・・文字列の一部分を返します。
split・・・文字列が複数の文字列に分割されたときの文字列の配列を返します。
substr・・・文字列内の、指定位置からの指定された長さを持つ部分を返します。
toLocaleLowerCase・・・ホスト環境の現在の国別情報に従って、すべての英字を小文字に変換した文字列を返します。
toLowerCase・・・すべての英字を小文字に変換した文字列を返します。
toString・・・オブジェクトの値を表す文字列を返します。
toUpperCase・・・すべての英字を大文字に変換した文字列を返します。

スポンサードリンク