【JavaScript ECMAScript】String::String.prototype.replaceインスタンスメソッドの使い方
String.prototype.replace()インスタンスメソッドの使い方について、初心者にもわかりやすく解説します。
作成日: 更新日:
基本的な使い方
String.prototype.replace()メソッドは、文字列内で特定のパターンを検索し、そのパターンに一致した部分を別の文字列または関数が返す値で置き換えるメソッドです。
このメソッドの重要な特徴は、元の文字列自体を変更せず、常に新しい文字列を生成して返す点です。したがって、元の文字列が意図せず変更される心配はなく、安心して利用できます。
利用する際には、主に二つの引数を指定します。一つ目は検索対象となるパターンで、これは具体的な文字列、または正規表現として指定できます。二つ目は置換内容で、これは置換後の文字列、または置換文字列を動的に生成するための関数として指定できます。
検索パターンとして正規表現を使用する場合、正規表現の「g」（グローバル）フラグの有無によって動作が変わります。グローバルフラグがない場合は最初に見つかった一致のみを置換しますが、グローバルフラグがある場合は、文字列内のすべての一致を置換します。関数を置換内容として指定すると、一致した部分やキャプチャグループに基づいて柔軟な置換処理を行うことが可能です。
最終的に、すべての置換処理が適用された新しい文字列がこのメソッドから返されます。
公式リファレンス: String.prototype.replace()
構文(syntax)
1"original string".replace("search value", "replace value");
引数(parameters)
searchValue, replaceValue
- searchValue: string | RegExp: 置換対象となる文字列または正規表現
- replaceValue: string | Function: 置換後の文字列、または置換処理を実行する関数
戻り値(return)
String
指定された検索パターンに一致する部分を、指定された置換文字列または関数で置き換えた新しい文字列を返します。元の文字列は変更されません。