Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Función REPLACE
<a name="REPLACE"></a>

Reemplaza todas las coincidencias de un conjunto de caracteres dentro de una cadena existente con otros caracteres especificados. 

REPLACE es similar a [Función TRANSLATE](TRANSLATE.md) y a [Función REGEXP\$1REPLACE](REGEXP_REPLACE.md), salvo que TRANSLATE realiza varias sustituciones de caracteres únicos y REGEXP\$1REPLACE le permite buscar un patrón de expresión regular en una cadena, mientras que REPLACE sustituye una cadena entera por otra cadena.

## Sintaxis
<a name="REPLACE-synopsis"></a>

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

## Argumentos
<a name="REPLACE-arguments"></a>

 *string*   
Cadena CHAR o VARCHAR que se buscará 

 *old\$1chars*   
Cadena CHAR o VARCHAR que se reemplazará. 

 *new\$1chars*   
Nueva cadena CHAR o VARCHAR que reemplaza a *old\$1string (cadena\$1anterior)*. 

## Tipo de devolución
<a name="REPLACE-return-type"></a>

VARCHAR

Si *old\$1chars* o *new\$1chars* es NULL, el valor devuelto es NULL. 

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

En el siguiente ejemplo, se convierte la cadena `Shows` en `Theatre` en el campo CATGROUP: 

```
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)
```