LTRIM (Transact-SQL)

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 à gauche.

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

Conventions de la syntaxe Transact-SQL

Syntaxe

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

LTRIM ( 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 avez besoin du niveau de compatibilité de votre base de données défini sur 160 pour utiliser l’argument caractères facultatifs.

LTRIM ( 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

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

Renvoie 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 du début d’une character_expression. Renvoie NULL si la chaîne d’entrée est NULL.

Notes

Pour activer l’argument positionnel de caractères facultatifs, activez le niveau 160 de compatibilité de la base de données sur la base de données à laquelle vous vous connectez lors de l’exécution de requêtes.

Exemples

R. Supprimer les espaces de début

L’exemple suivant utilise LTRIM pour supprimer les espaces de début d’une expression de caractères.

SELECT LTRIM('     Five spaces are at the beginning of this string.');

Voici le jeu de résultats.

---------------------------------------------------------------
  Five spaces are at the beginning of this string.

B : Supprimer des espaces de début à l’aide d’une variable

L'exemple suivant utilise LTRIM pour supprimer les espaces à droite d'une variable caractère.

DECLARE @string_to_trim VARCHAR(60);
SET @string_to_trim = '     Five spaces are at the beginning of this string.';
SELECT
    @string_to_trim AS 'Original string',
    LTRIM(@string_to_trim) AS 'Without spaces';
GO

Voici le jeu de résultats.

Original string                                            Without spaces
-----------------------------------------------------   ---------------------------------------------
     Five spaces are at the beginning of this string.    Five spaces are at the beginning of this string.

C. Supprimer les caractères spécifiés du début d’une chaîne

Important

Vous avez besoin du niveau de compatibilité de votre base de données pour 160 utiliser l’argument de caractères facultatifs.

L’exemple suivant supprime les caractères 123 du début de la chaîne 123abc..

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

Voici le jeu de résultats.

abc.