Função Left

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

Sintaxe

Left ( cadeia, comprimento )

A sintaxe da função esquerda tem os seguintes 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 nulo, será retornado nulo.

comprimento

Obrigatório. Variante (Longo). expressão numérica indicando quantos caracteres você deve retornar. Se 0, uma cadeia de comprimento zero ("") será retornada. Se for maior ou igual ao número de caracteres na cadeiade caracteres, a cadeia de caracteres inteira 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 ESQUERDAB com dados de bytes contidos em uma cadeia de caracteres. Em vez de especificar o número de caracteres a serem retornados, Length especifica o número de bytes.

Exemplo de consulta

Expressão

Resultados

Selecione esquerda (ProductID, 3) como FromLeft da ProductSales;

Retorna ' 3 ' caracteres 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 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.

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

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

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

Precisa de mais ajuda?

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.

×