LEN (Transact-SQL)
Retorna o número de caracteres da expressão da cadeia de caracteres especificada, excluindo espaços em branco à direita.
Dica
Para retornar o número de bytes usado para representar uma expressão, use a função DATALENGTH.
Aplica-se a: SQL Server (SQL Server 2008 até a versão atual), Banco de dados SQL do Windows Azure (versão inicial até a versão atual). |
.gif "Ícone de vínculo de tópico")
Convenções da sintaxe Transact-SQL
Sintaxe
LEN ( string_expression )
Argumentos
- string_expression
É a expressão da cadeia de caracteres a ser avaliada. string_expression pode ser uma constante, uma variável ou uma coluna de dados de caracteres ou binários.
Tipos de retorno
bigint se expression for dos tipos de dados varchar(max), nvarchar(max) ou varbinary(max); caso contrário, int.
Se você estiver usando agrupamentos de caracteres suplementares, o valor inteiro retornado contará os pares alternativos UTF-16 como um único caractere. Para obter mais informações, consulte Suporte a agrupamentos e a Unicode.
Exemplos
O exemplo a seguir seleciona o número de caracteres e os dados de FirstName para pessoas localizadas na Australia. Este exemplo usa o banco de dados AdventureWorks2012.
SELECT LEN(FirstName) AS Length, FirstName, LastName
FROM Sales.vIndividualCustomer
WHERE CountryRegionName = 'Australia';
GO