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

Retorna uma Variante (Cadeia) que contém um número especificado de caracteres do lado esquerdo de uma cadeia.

Sintaxe

Esquerda( cadeia de caracteres, comprimento )

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

Argumento

Descrição

cadeia

Obrigatório. Expressão de cadeia de caracteres cujos caracteres à esquerda são retornados. Se a cadeia de caracteres contiver Null, Null será retornado.

comprimento

Obrigatório. Variant (Long). expressão numérica indicando quantos caracteres devem ser retornados. Se 0, uma cadeia de comprimento zero ("") será retornada. Se maior ou igual ao número de caracteres na cadeia de caracteres, toda a cadeia de caracteres será retornada.

Comentários

Para determinar o número de caracteres na cadeia de caracteres, use a função Len .

Observação:  Use a função LeftB com dados de bytes contidos em uma cadeia de caracteres. Em vez de especificar o número de caracteres a serem retornados, o comprimento especifica o número de bytes.

Exemplo de consulta

Expressão

Resultados

SELECT Left(ProductID,3) AS FromLeft FROM ProductSales;

Retorna caracteres '3' do lado esquerdo dos valores no campo "ProductID" da tabela "ProductSales" na coluna FromLeft.

Exemplo 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.

Este exemplo usa a função Left para retornar um número especificado de caracteres do lado esquerdo de uma cadeia de caracteres.

Dim AnyString, MyStrAnyString = "Hello World"    ' Define string.MyStr = Left(AnyString, 1)    ' Returns "H".MyStr = Left(AnyString, 7)    ' Returns "Hello W".MyStr = Left(AnyString, 20)    ' Returns "Hello World".

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.