Applies ToAccess para Microsoft 365 Access 2024 Access 2021 Access 2019 Access 2016

Retorna um Long 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( string | varname)

A sintaxe da função Len tem esses argumentos:

Argumento

Descrição

cadeia de caracteres

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

nomedavariável

Qualquer nome de variável válido. Se varname contiver Null, Null será retornado. Se varname for uma Variant, Len o tratará da mesma forma que uma Cadeia de Caracteres e sempre retornará o número de caracteres que ele contém.

Comentários

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

Observação:  Use a função LenB com dados de bytes contidos em uma cadeia de caracteres, como em idiomas DBCS (conjunto de caracteres de byte duplo). Em vez de retornar o número de caracteres em uma cadeia de caracteres, LenB retorna o número de bytes usados para representar essa cadeia de caracteres. Com tipos definidos pelo usuário, o LenB retorna o tamanho na memória, incluindo qualquer preenchimento entre elementos. Para obter o código de exemplo que usa o LenB, 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á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

SELECT ProductID, Len(ProductID) AS ProductLen FROM ProductSales;

Retorna os valores do campo "ProductID" e o comprimento desses valores nas colunas ProductLen.

Exemplos de VBA

Observação: Exemplos a seguir demonstram o uso dessa função em um módulo VBA (Visual Basic for Applications). 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... A definição de bloco de tipo final CustomerRecord deve ser precedida pelo palavra-chave Private se ele 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 * 30End TypeDim Customer As CustomerRecord    ' Declare variables.Dim MyInt As Integer, MyCur As CurrencyDim MyString, MyLenMyString = "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 LenB 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 for usado para representar a cadeia de caracteres.

Function LenMbcs (ByVal str as String)    LenMbcs = LenB(StrConv(str, vbFromUnicode))End FunctionDim MyString, MyLenMyString = "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.

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

Precisa de mais ajuda?

Quer mais opções

Explore os benefícios da assinatura, procure cursos de treinamento, saiba como proteger seu dispositivo e muito mais.

As comunidades ajudam você a fazer e responder perguntas, fazer comentários e ouvir especialistas com conhecimento avançado.