names=gsub
visibility=public
kind=defined

--- gsub(pattern, replace)          -> String
--- gsub(pattern) {|matched| ... }  -> String
--- gsub(pattern)                   -> Enumerator

$_.gsub とほぼ同じですが、置換が発生したときは、$_の内容を置き換える点が異なります。
コマンドラインオプションで -p または -n を指定した時のみ定義されます。


暗号的になりすぎるきらいがあるため、このメソッドの使用は推奨されていません。
今後はより明示的な $_.gsub を使ってください。

$_.gsub とこのメソッド gsub は以下の点で違いがあります。

  * gsub は $_ の値をコピーして、コピーの方を更新し、
  $_ に再代入します。


@param pattern    置き換える文字列のパターンを表す文字列か正規表現。
                  文字列を指定した場合は全く同じ文字列にだけマッチする
@param replace    pattern で指定した文字列と置き換える文字列

@see [[m:String#gsub]],[[m:$_]]

