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_expression1 , string_expression2 , string_expression3 )

Argumentos

  • string_expression1
    Es la expresión de cadena que se va a buscar. string_expression1 puede tener un tipo de datos de carácter o binario.
  • string_expression2
    La subcadena que se va a buscar. string_expression2 puede tener un tipo de datos de carácter o binario.
  • string_expression3
    Cadena de reemplazo. string_expression3 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)

Vea también

Referencia

Tipos de datos (Transact-SQL)
Funciones de cadena (Transact-SQL)

Ayuda e información

Obtener ayuda sobre SQL Server 2005