REPLACE (Transact-SQL)

Remplace toutes les occurrences d'une valeur de type chaîne spécifiée par une autre valeur de type chaîne.

Icône Lien de rubriqueConventions de la syntaxe de Transact-SQL

Syntaxe

REPLACE ( string_expression1 , string_expression2 , string_expression3 )

Arguments

  • string_expression1
    Il s'agit de l'expression de chaîne dans laquelle effectuer la recherche. string_expression1 peut être de type binaire ou caractère.
  • string_expression2
    Il s'agit de la sous-chaîne à rechercher. string_expression2 peut être de type binaire ou caractère.
  • string_expression3
    Il s'agit de l'expression de chaîne de remplacement. string_expression3 peut être de type binaire ou caractère.

Notes

REPLACE effectue des comparaisons basées sur le classement de l'entrée. Pour réaliser une comparaison dans un classement spécifique, vous pouvez utiliser COLLATE afin d'appliquer un classement explicite à l'entrée.

Types de retour

Retourne nvarchar si l'un des arguments d'entrée est de type nvarchar ; dans le cas contraire, REPLACE retourne varchar.

Retourne NULL si n'importe lequel des arguments a pour valeur NULL.

Exemples

L'exemple suivant remplace la chaîne cde dans abcdefghi par xxx.

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

Voici l'ensemble des résultats.

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

L'exemple suivant utilise la fonction COLLATE.

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

Voici l'ensemble des résultats.

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

Voir aussi

Référence

Types de données (Transact-SQL)
Fonctions de chaîne (Transact-SQL)

Aide et Informations

Assistance sur SQL Server 2005