Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
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)