Função Left

Retorna uma Variant (String) que contém um número especificado de caracteres do lado esquerdo de uma string.

Sintaxe

Esquerda(string, comprimento)

A sintaxe da função Left tem estes argumentos nomeados:

Sair Descrição
cadeia de caracteres Obrigatório. Expressão de cadeia de caracteres da qual os caracteres mais à esquerda são retornados. Se a cadeia de caracteres contiver Null, Null será retornado.
comprimento Obrigatório; Variante (Longa). Expressão numérica que indica quantos caracteres retornar. Se for 0, retornará uma cadeia de comprimento zero (""). Se for maior que ou igual ao número de caracteres na cadeia de 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 LeftB com dados de byte contidos em uma cadeia de caracteres. Em vez de especificar o número de caracteres a retornar, o comprimento especifica o número de bytes.

Exemplo

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, 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".

Confira também

Suporte e comentários

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.

  • Last updated on