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

Sintaxe

Esquerda( cadeia, comprimento )

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

Argumento

Descrição

cadeia

Obrigatório. Expressão de cadeia da qual são devolvidos os carateres mais à esquerda. Se a cadeia contiver Nulo, Nulo é devolvido.

comprimento

Obrigatório. Variante (Longo). expressão numérica que indica o número de carateres a devolver. Se for 0, será devolvida uma cadeia de comprimento zero (""). Se for maior ou igual ao número de carateres na cadeia, é devolvida toda a cadeia.

Comentários

Para determinar o número de carateres na cadeia, utilize a função Núm. carat.

Nota:  Utilize a função EsquerdaB com dados de byte contidos numa cadeia. Em vez de especificar o número de carateres a devolver, o comprimento especifica o número de bytes.

Exemplo de consulta

Expressão

Resultados

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

Devolve "3" carateres do lado esquerdo dos valores no campo "ProductID" da tabela "Vendas de Produtos" na coluna FromLeft.

Exemplo de VBA

Nota: Os exemplos seguintes demonstram a utilização desta função no módulo VBA (Visual Basic for Applications). Para obter mais informações sobre como trabalhar com o VBA, selecione Referência para Programadores na lista pendente junto a Procurar e introduza um ou mais termos na caixa de pesquisa.

Este exemplo utiliza a função Esquerda para devolver um número específico de carateres a partir do lado esquerdo de uma cadeia.

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 e como utilizá-las

Precisa de mais ajuda?

Quer mais opções?

Explore os benefícios da subscrição, navegue em cursos de formação, saiba como proteger o seu dispositivo e muito mais.

As comunidades ajudam-no a colocar e a responder perguntas, a dar feedback e a ouvir especialistas com conhecimentos abrangentes.