LTRIM (Transact-SQL)

  • Article

S’applique à :SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)Point de terminaison analytique SQL dans Microsoft FabricEntrepôt dans 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 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.

LTRIM ( character_expression , [ characters ] )

Remarque

Pour afficher la syntaxe Transact-SQL pour SQL Server 2014 (12.x) et versions antérieures, consultez Versions antérieures de la documentation.

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.

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 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 obtenu.

---------------------------------------------------------------  
  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 obtenu.

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 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 123 du début de la chaîne 123abc..

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

Voici le jeu de résultats obtenu.

abc.

Voir aussi