• Article

LEFT (Transact-SQL)

Retourne la partie de gauche d'une chaîne de caractères avec le nombre spécifié de caractères.

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

Syntaxe

LEFT ( character_expression , integer_expression )

Arguments

  • character_expression
    Expression de données binaires ou de caractères. character_expression peut être une constante, une variable ou une colonne. character_expression peut être de tout type de données, hormis text ou ntext, qui peut être converti implicitement en type varchar ou nvarchar. Sinon, utilisez la fonction CAST pour convertir explicitement character_expression.

  • integer_expression
    Entier positif indiquant combien de caractères de character_expression seront retournés. Si l'argument integer_expression est négatif, une erreur est retournée. Si integer_expression est de type bigint et contient une valeur élevée, character_expression doit être un type de données volumineux, tel que varchar(max).

Types de retour

Retourne varchar lorsque character_expression est un type de données de caractères non-Unicode.

Retourne nvarchar lorsque character_expression est un type de données de caractères Unicode.

Notes

Les niveaux de compatibilité peuvent affecter les valeurs retournées. Pour plus d'informations sur les niveaux de compatibilité, consultez sp_dbcmptlevel (Transact-SQL).

Exemples

A. Utilisation de LEFT avec une colonne

L'exemple suivant retourne les cinq caractères les plus à gauche du nom de chaque produit.

USE AdventureWorks2008R2;
GO
SELECT LEFT(Name, 5) 
FROM Production.Product
ORDER BY ProductID;
GO

B. Utilisation de LEFT avec une chaîne de caractères

L'exemple suivant utilise LEFT pour retourner les deux caractères les plus à gauche de la chaîne de caractères abcdefg.

SELECT LEFT('abcdefg',2)
GO

Voici l'ensemble des résultats.

--

ab

(1 row(s) affected)