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 type caractère ou binaire. character_expression peut être une constante, une variable ou une colonne. character_expression peut être de tout type de données, à l'exception de text ou de ntext, implicitement convertible en varchar ou en nvarchar. Sinon, utilisez la fonction CAST pour convertir explicitement character_expression.

integer_expression

Entier positif qui spécifie le nombre de caractères de character_expression à retourner. Si integer_expression est négatif, une erreur est retournée. integer_expression peut être de type bigint.

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

Types de retour

varchar ou nvarchar

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 AdventureWorks;
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 LEFT.

SELECT LEFT('abcdefg',2)
GO

Voici l'ensemble des résultats. 

-- 
ab 

(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