翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# REPLACE 関数
<a name="REPLACE"></a>

既存の文字列内の一連の文字をすべて、指定された他の文字に置き換えます。

REPLACE は、[TRANSLATE 関数](TRANSLATE.md)や [REGEXP\$1REPLACE 関数](REGEXP_REPLACE.md) と似ています。ただし、TRANSLATE は複数の単一文字置換を行い、REGEXP\$1REPLACE を使用すると正規表現パターンの文字列を検索できますが、REPLACE は 1 つの文字列全体を別の文字列に置換します。

## 構文
<a name="REPLACE-synopsis"></a>

```
REPLACE(string1, old_chars, new_chars)
```

## 引数
<a name="REPLACE-arguments"></a>

 *string*   
検索する CHAR 型または VARCHAR 型の文字列。

 *old\$1chars*   
置き換える CHAR 型または VARCHAR 型の文字列。

 *new\$1chars*   
*old\$1string* を置き換える新しい CHAR 型または VARCHAR 型の文字列。

## 戻り型
<a name="REPLACE-return-type"></a>

VARCHAR

*old\$1chars* または *new\$1chars* のいずれかが NULL の場合、戻り値は NULL です。

## 例
<a name="REPLACE-examples"></a>

次の例では、CATGROUP フィールド内の文字列 `Shows` を `Theatre` に変換します。

```
select catid, catgroup,
replace(catgroup, 'Shows', 'Theatre')
from category
order by 1,2,3;

 catid | catgroup | replace
-------+----------+----------
     1 | Sports   | Sports
     2 | Sports   | Sports
     3 | Sports   | Sports
     4 | Sports   | Sports
     5 | Sports   | Sports
     6 | Shows    | Theatre
     7 | Shows    | Theatre
     8 | Shows    | Theatre
     9 | Concerts | Concerts
    10 | Concerts | Concerts
    11 | Concerts | Concerts
(11 rows)
```