LEFT (Transact-SQL)
Retourne la partie de gauche d'une chaîne de caractères avec le nombre spécifié de caractères.
.gif "Icône Lien de rubrique")
Conventions de la syntaxe 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 n'importe quel type de données, à l'exception de text ou ntext, qui peut être implicitement converti en 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).Le paramètre integer_expression compte un caractère de substitution UTF-16 comme un caractère.
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
Lors de l'utilisation de classements SC, le paramètre integer_expression compte une paire de substitution UTF-16 comme un caractère. Pour plus d'informations, consultez Prise en charge d'Unicode et du classement.
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 AdventureWorks2012;
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)
Voir aussi
Référence
CAST et CONVERT (Transact-SQL)