JavaScript replace()メソッド
JavaScript String オブジェクト例
この例では、最初の "Microsoft" が見つかったときに、それを "サンプル" に置き換える置換を1回実行します。
var str="Visit Microsoft! Visit Microsoft!";
var n=str.replace("Microsoft","サンプル");
n出力結果:
Visit サンプル!Visit Microsoft!
試してみる »
定義と用法
replace() メソッドは、文字列内の一部の文字を別の文字に置き換えたり、正規表現に一致する部分文字列を置き換えたりするために使用されます。
正規表現のチュートリアルについてもっと知りたい場合は、当サイトの以下を参照してください：RegExp チュートリアルおよびRegExp オブジェクトリファレンス.
このメソッドは元の文字列を変更しません。
ブラウザサポート
すべての主要ブラウザが replace() メソッドをサポートしています。
構文
string.replace(searchvalue,newvalue)
パラメータ値
| パラメータ | 説明 |
|---|---|
| searchvalue | 必須。置き換える部分文字列またはパターンを指定する RegExp オブジェクト。 この値が文字列の場合、最初に RegExp オブジェクトに変換されるのではなく、検索対象のリテラルテキストパターンとして扱われることに注意してください。 |
| newvalue | 必須。文字列値。置換テキストまたは置換テキストを生成する関数を指定します。 |
戻り値
| 型 | 説明 |
|---|---|
| String | regexp の最初の一致またはすべての一致を replacement で置き換えた後に得られる新しい文字列。 |
技術詳細
| JavaScript バージョン： | 1.2 |
|---|
その他の例
例
グローバル置換を実行します:
var str="Mr Blue has a blue house and a blue car";
var n=str.replace(/blue/g,"red");
n出力結果:
Mr Blue has a red house and a red car
試してみる »
例
大文字と小文字を区別せずにグローバル置換を実行します:
var str="Mr Blue has a blue house and a blue car";
var n=str.replace(/blue/gi, "red");
n出力結果:
Mr red has a red house and a red car
試してみる »
例
この例では、prototype を使用して JavaScript の String オブジェクトにメソッドを追加し、すべての "Microsoft" を "サンプル" に置き換えることを実現します。
String.prototype.replaceAll = function(search, replacement) {
var target = this;
return target.replace(new RegExp(search, 'g'), replacement);
};
試してみる »
その他の拡張