Função Len

Importante :  Este artigo foi traduzido por um sistema de tradução automática, leia o aviso de isenção de responsabilidade. Para sua referência, veja a versão em inglês deste artigo aqui.

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 uma variável.

Sintaxe

Len ( cadeia | NOMEDAVARIÁVEL)

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

Argumento

Descrição

cadeia de caracteres

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

NOMEDAVARIÁVEL

Qualquer nome válido variável. Se NOMEDAVARIÁVEL contiver Nulo, nulo será retornado. Se NOMEDAVARIÁVEL é uma variante, Len o tratará como uma cadeia de caracteres e sempre retorna o número de caracteres que ele 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 Núm. CARACTB com dados de byte contidos em uma cadeia de caracteres, como em conjunto de caracteres de dois bytes (DBCS) idiomas. Em vez de retornar o número de caracteres em uma cadeia de caracteres, Núm. CARACTB retorna o número de bytes usados para representar essa cadeia de caracteres. Com tipos definidos pelo usuário, Núm. CARACTB retorna o tamanho de memória, incluindo qualquer preenchimento entre elementos. Para o código de exemplo que usa CARACTB, consulte o segundo exemplo no tópico de exemplo.

Observação : Len pode não ser capaz de determinar o número real de bytes de armazenamento necessário quando usado com cadeias de caracteres de comprimento variável em tipos de dados definidos pelo usuário.

Exemplo

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

O primeiro exemplo usa caract 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 de ... Tipo de término bloco definindo CustomerRecord deve ser precedido a palavra-chave privada se aparecer em um módulo de classe. Em um módulo padrão, uma instrução de tipo 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 bytes em uma cadeia de caracteres se ANSI é 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 : Aviso de Isenção de Tradução Automática: Este artigo foi traduzido por computador, sem intervenção humana. A Microsoft oferece essas traduções automáticas para ajudar as pessoas que não falam inglês a aproveitar os textos escritos sobre produtos, serviços e tecnologias da Microsoft. Como este artigo foi traduzido automaticamente, é possível que contenha erros de vocabulário, sintaxe ou gramática.

Expanda suas habilidades
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.

×