Função Len

Retorna um longo que contém o número de caracteres em uma cadeia de caracteres ou o número de bytes necessários para armazenar um variável.

Sintaxe

Len ( cadeia | VarName)

A sintaxe da função Len tem os seguintes argumentos:

Argumento

Descrição

cadeia de caracteres

Qualquer expressão de cadeia de caracteres válido. Se a cadeia de caracteres contiver nulo, será retornado nulo.

nomedavariável

Qualquer nome de variável válido. Se VarName contiver nulo, será retornado nulo. Se VarName for uma variante, Len a tratará igual a uma cadeia de caracteres e sempre retorna o número de caracteres que ela contém.

Comentários

Um (e somente um) dos dois argumentos possíveis deve ser especificado. Com tipos definidos pelo usuário, Len retorna o tamanho como ele será gravado no arquivo.

Observação:  Use a função caractb com dados de bytes contidos em uma cadeia de caracteres, como em idiomas do conjunto de caracteres de dois bytes (DBCS). Em vez de retornar o número de caracteres em uma cadeia de caracteres, caractb retorna o número de bytes usados para representar essa cadeia de caracteres. Com tipos definidos pelo usuário, caractb retorna o tamanho da memória, incluindo qualquer preenchimento entre elementos. Para obter um exemplo de código que usa caractb, consulte o segundo exemplo no tópico de exemplo.

Observação: Len podem não conseguir determinar o número real de bytes de armazenamento necessários quando usados com cadeias de caracteres de comprimento variável em tipos de dados definidos pelo usuário.

Exemplo de consulta

Expressão

Resultados

SELECIONE ProductID, Len (ProductID) AS ProductLen de ProductSales;

Retorna os valores do campo "ProductID" e o comprimento dos valores na coluna ProductLen.

Exemplos do VBA

Observação: Exemplos a seguir demonstram o uso dessa função em um módulo do Visual Basic for Applications (VBA). Para obter mais informações sobre como trabalhar com o VBA, selecione referência do desenvolvedor na lista suspensa ao lado de Pesquisar e insira um ou mais termos na caixa de pesquisa.

O primeiro exemplo usa Len para retornar o número de caracteres em uma cadeia de caracteres ou o número de bytes necessários para armazenar uma variável. O tipo... Bloco de tipo end definindo CustomerRecord deve ser precedido pela palavra-chave Private se ela aparecer em um módulo de classe. Em um módulo padrão, uma instrução Type pode ser pública.

Type CustomerRecord    ' Define user-defined type.
ID As Integer ' Place this definition in a
Name As String * 10 ' standard module.
Address As String * 30
End Type
Dim Customer As CustomerRecord ' Declare variables.
Dim MyInt As Integer, MyCur As Currency
Dim MyString, MyLen
MyString = "Hello World" ' Initialize variable.
MyLen = Len(MyInt) ' Returns 2.
MyLen = Len(Customer) ' Returns 42.
MyLen = Len(MyString) ' Returns 11.
MyLen = Len(MyCur) ' Returns 8.

O segundo exemplo usa caractb e uma função definida pelo usuário (LenMbcs) para retornar o número de caracteres de byte em uma cadeia de caracteres se ANSI for usado para representar a cadeia de caracteres.

Function LenMbcs (ByVal str as String)
LenMbcs = LenB(StrConv(str, vbFromUnicode))
End Function
Dim MyString, MyLen
MyString = "ABc"
' Where "A" and "B" are DBCS and "c" is SBCS.
MyLen = Len(MyString)
' Returns 3 - 3 characters in the string.
MyLen = LenB(MyString)
' Returns 6 - 6 bytes used for Unicode.
MyLen = LenMbcs(MyString)
' Returns 5 - 5 bytes used for ANSI.

Observação:  Esta página foi traduzida automaticamente e pode apresentar erros gramaticais ou imprecisões. Nosso objetivo é que este conteúdo seja útil para você. Você pode nos dizer se as informações foram úteis? Use o artigo em inglês como referência.​

Consulte Também

As funções de cadeia de caracteres e como usá-las

Expanda suas habilidades no Office
Explore o treinamento
Obtenha novos recursos primeiro
Ingressar no Office Insider

Essas informações foram úteis?

Obrigado por seus comentários!

Agradecemos pelos seus comentários! Parece que pode ser útil conectar você a um de nossos agentes de suporte do Office.

×