Compartilhar via


LEN (Transact-SQL)

Retorna o número de caracteres da expressão da cadeia de caracteres especificada, excluindo espaços em branco à direita.

ObservaçãoObservação

Para retornar o número de bytes usado para representar uma expressão, use a função DATALENGTH.

Ícone de vínculo de tópico Convenções de sintaxe Transact-SQL

Sintaxe

LEN ( string_expression )

Argumentos

  • string_expression
    É a cadeia de caracteres expression a ser avaliada. string_expression pode ser uma constante, variável ou 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.

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

Consulte também

Referência

Tipos de dados (Transact-SQL)

Funções de cadeia de caracteres (Transact-SQL)

DATALENGTH (Transact-SQL)

LEFT (Transact-SQL)

RIGHT (Transact-SQL)