replace (String - JavaScript)

サブストリングを置換します。

定義場所

構文

replace(searchValue:string, replaceValue:string) : string

replace(searchValue:RegExp, replaceValue:string) : string

パラメータ	説明
`searchValue`	置換するサブストリング。
`replaceValue`	置換サブストリング。

戻り値	説明
`string`	置換後のストリング。

使用法

置換するサブストリングがストリングに含まれていない場合、戻り値は元のストリングになります。

最初のパラメータがストリングの場合、このメソッドは、完全一致する最初のストリングを置換します。最初のパラメータが正規表現の場合、このメソッドは、正規表現の構文に従って一致するストリングすべてを置換します。

例

(1) この例では、Paris---Moscow Tokyo が返されます。

var cities = new String("Paris   Moscow   Tokyo");
cities.replace("   ", "---")

(2) この例では、Paris---Moscow---Tokyo が返されます。

var cities = new String("Paris   Moscow   Tokyo");
var cities2 = cities.replace("   ", "---");
while (! cities.equals(cities2)) {
	cities = cities2;
	cities2 = cities.replace("   ", "---");
}
cities

(3) この例でも、JavaScript 反復ではなく正規表現を使用して、Paris---Moscow---Tokyo が返されます。

var cities = new String("Paris   Moscow   Tokyo");
cities.replace(/(   )/g, "---")