REPLACE (Transact-SQL)

Reemplaza todas las instancias de un valor de cadena especificado por otro valor de cadena.

Icono de vínculo a temasConvenciones de sintaxis de Transact-SQL

Sintaxis

REPLACE ( string_expression , string_pattern , string_replacement )

Argumentos

  • string_expression
    Es la expresión de cadena en la que se va a buscar. string_expression puede tener un tipo de datos de carácter o binario.

  • string_pattern
    Es la subcadena que se va a buscar. string_pattern puede ser de un tipo de datos de carácter o binario. string_pattern no puede ser una cadena vacía (").

  • string_replacement
    Cadena de reemplazo. string_replacement puede tener un tipo de datos de carácter o binario.

Tipos de valor devueltos

Devuelve nvarchar si uno de los argumentos de entrada tiene el tipo de datos nvarchar; de lo contrario, REPLACE devuelve varchar.

Devuelve NULL si alguno de los argumentos es NULL.

Notas

REPLACE realiza comparaciones basándose en la intercalación de la entrada. Para realizar una comparación en la intercalación especificada, puede utilizar COLLATE para aplicar una intercalación explícita a la entrada.

Ejemplos

El siguiente ejemplo reemplaza la cadena cde de abcdefghi por xxx.

SELECT REPLACE('abcdefghicde','cde','xxx');
GO

Éste es el conjunto de resultados.

------------
abxxxfghixxx
(1 row(s) affected)

El siguiente ejemplo utiliza la función COLLATE.

SELECT    REPLACE('Das ist ein Test'  COLLATE Latin1_General_BIN,
'Test', 'desk' );
GO

Éste es el conjunto de resultados.

------------
Das ist ein desk
(1 row(s) affected)