RTRIM (Transact-SQL)

  • Article

S’applique à : SQL Server Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System (PDW) SQL analytics endpoint in Microsoft Fabric Warehouse in Microsoft Fabric

Retourne une chaîne de caractères après avoir tronqué tous les espaces à droite.

Supprime le caractère espace char(32) ou d’autres caractères spécifiés à la fin d’une chaîne.

Conventions de la syntaxe Transact-SQL

Syntaxe

Syntaxe SQL Server avant SQL Server 2022 (16.x) :

RTRIM ( character_expression )

Syntaxe pour SQL Server 2022 (16.x) et versions ultérieures, Azure SQL Managed Instance, Azure SQL Database, Azure Synapse Analytics, et Microsoft Fabric :

Important

Vous aurez besoin que le niveau de compatibilité de votre base de données soit défini sur 160 pour pouvoir utiliser l’argument characters facultatif.

RTRIM ( character_expression , [ characters ] )

Arguments

expression_caractère

Une expression de données binaires ou caractères. character_expression peut être une constante, une variable ou une colonne. character_expression doit être d’un type de données, à l’exception de text, ntext et image, pouvant être implicitement converti en varchar. Sinon, utilisez la fonction CAST pour convertir explicitement character_expression.

caractères

S’applique à : SQL Server 2022 (16.x) et versions ultérieures.

Un littéral, une variable ou un appel de fonction de tout type de caractère non LOB (nvarchar, varchar, nchar ou char) contenant des caractères à supprimer. Les types nvarchar(max) et varchar(max) ne sont pas autorisés.

Types de retour

Retourne une expression de caractères avec un type d’argument de chaîne dans laquelle le caractère espace char(32) ou d’autres caractères spécifiés sont supprimés à la fin d’une character_expression. Renvoie NULL si la chaîne d’entrée est NULL.

Remarques

Pour activer l’argument positionnel facultatif characters, activez le niveau de compatibilité de base de données 160 sur la ou les bases de données auxquelles vous vous connectez lors de l’exécution des requêtes.

Exemples

R. Supprimer des espaces de fin

L'exemple suivant accepte une chaîne de caractères qui contient des espaces à la fin de la phrase, et retourne le texte sans espaces à la fin de la phrase.

SELECT RTRIM('Removes trailing spaces.   ');

Voici le jeu de résultats.

Removes trailing spaces.

B. Supprimer les espaces de fin avec une variable

Cet exemple illustre l'utilisation de RTRIM pour supprimer les espaces à droite d'une variable caractère.

DECLARE @string_to_trim VARCHAR(60);  
SET @string_to_trim = 'Four spaces are after the period in this sentence.    ';  
SELECT @string_to_trim + ' Next string.';  
SELECT RTRIM(@string_to_trim) + ' Next string.';  
GO

Voici le jeu de résultats.

Four spaces are after the period in this sentence.     Next string.

Four spaces are after the period in this sentence. Next string.

C. Supprimer les caractères spécifiés de la fin d’une chaîne de caractères

Important

Vous aurez besoin que le niveau de compatibilité de votre base de données soit défini sur 160 pour pouvoir utiliser l’argument characters facultatif.

L’exemple suivant supprime les caractères abc. de la fin de la chaîne .123abc..

SELECT RTRIM('.123abc.' , 'abc.');

Voici le jeu de résultats.

.123

Voir aussi