LEN (Transact-SQL)LEN (Transact-SQL)

CETTE RUBRIQUE S’APPLIQUE À :ouiSQL Server (à partir de la version 2008)ouiAzure SQL DatabaseouiAzure SQL Data Warehouse ouiParallel Data Warehouse THIS TOPIC APPLIES TO: yesSQL Server (starting with 2008)yesAzure SQL DatabaseyesAzure SQL Data Warehouse yesParallel Data Warehouse

Retourne le nombre de caractères de l'expression de type chaîne spécifiée, à l'exception des espaces de droite.Returns the number of characters of the specified string expression, excluding trailing blanks.

Note

Pour retourner le nombre d’octets utilisés pour représenter une expression, utilisez la DATALENGTH (fonction).To return the number of bytes used to represent an expression, use the DATALENGTH function.

Icône de lien de rubrique Conventions de la syntaxe Transact-SQLTopic link icon Transact-SQL Syntax Conventions

SyntaxeSyntax

LEN ( string_expression )  

ArgumentsArguments

string_expressionstring_expression
La chaîne expression à évaluer.Is the string expression to be evaluated. string_expression peut être une constante, une variable ou une colonne de données binaire ou caractère.string_expression can be a constant, variable, or column of either character or binary data.

Types de retourReturn Types

bigint si expression est de le varchar (max), nvarchar (max) ou varbinary (max) des types de données ; sinon, int.bigint if expression is of the varchar(max), nvarchar(max) or varbinary(max) data types; otherwise, int.

Si vous utilisez des classements SC, la valeur entière retournée compte les paires de substitution UTF-16 comme un caractère unique.If you are using SC collations, the returned integer value counts UTF-16 surrogate pairs as a single character. Pour plus d’informations, consultez Prise en charge d’Unicode et du classement.For more information, see Collation and Unicode Support.

NotesRemarks

LEN exclut les espaces à droite.LEN excludes trailing blanks. Si c’est un problème, envisagez d’utiliser le DATALENGTH ( Transact-SQL ) fonction qui ne les supprime pas.If that is a problem, consider using the DATALENGTH (Transact-SQL) function which does not trim the string. Si le traitement d’une chaîne unicode, DATALENGTH retourne deux fois le nombre de caractères.If processing a unicode string, DATALENGTH will return twice the number of characters. L’exemple suivant montre la fonction LEN et DATALENGTH avec un espace de fin.The following example demonstrates LEN and DATALENGTH with a trailing space.

DECLARE @v1 varchar(40),  
    @v2 nvarchar(40);  
SELECT   
@v1 = 'Test of 22 characters ',   
@v2 = 'Test of 22 characters ';  
SELECT LEN(@v1) AS [varchar LEN] , DATALENGTH(@v1) AS [varchar DATALENGTH];  
SELECT LEN(@v2) AS [nvarchar LEN], DATALENGTH(@v2) AS [nvarchar DATALENGTH];  

ExemplesExamples

L'exemple suivant sélectionne le nombre de caractères et les données figurant dans FirstName pour les personnes résidant en Australia.The following example selects the number of characters and the data in FirstName for people located in Australia. Cet exemple utilise la base de données AdventureWorks2012AdventureWorks2012.This example uses the AdventureWorks2012AdventureWorks2012 database.

SELECT LEN(FirstName) AS Length, FirstName, LastName   
FROM Sales.vIndividualCustomer  
WHERE CountryRegionName = 'Australia';  
GO  

Exemples : Azure SQL Data WarehouseAzure SQL Data Warehouse et Parallel Data WarehouseParallel Data WarehouseExamples: Azure SQL Data WarehouseAzure SQL Data Warehouse and Parallel Data WarehouseParallel Data Warehouse

L’exemple suivant retourne le nombre de caractères dans la colonne FirstName et les premier et les noms des employés se trouve dans Australia.The following example returns the number of characters in the column FirstName and the first and last names of employees located in Australia.

-- Uses AdventureWorks  

SELECT DISTINCT LEN(FirstName) AS FNameLength, FirstName, LastName   
FROM dbo.DimEmployee AS e  
INNER JOIN dbo.DimGeography AS g   
    ON e.SalesTerritoryKey = g.SalesTerritoryKey   
WHERE EnglishCountryRegionName = 'Australia';  

Voici l'ensemble des résultats.Here is the result set.

FNameLength  FirstName  LastName  
-----------  ---------  ---------------  
4            Lynn       Tsoflias

Voir aussiSee Also

Types de données (Transact-SQL) Data Types (Transact-SQL)
Fonctions de chaîne ( Transact-SQL ) String Functions (Transact-SQL)
DATALENGTH ( Transact-SQL ) DATALENGTH (Transact-SQL)
GAUCHE ( Transact-SQL ) LEFT (Transact-SQL)
DROITE ( Transact-SQL )RIGHT (Transact-SQL)