Função esquerda

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 estes argumentos nomeados:

Sair	Descrição
cadeia de caracteres	Obrigatório. Expressão de cadeia a partir da qual são devolvidos os carateres mais à esquerda. Se a cadeia de caracteres contiver Null, Null será retornado.
comprimento	Necessário; Variante (Longo). Expressão numérica que indica quantos carateres pretende devolver. Se for 0, é 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 caracteres na cadeia de caracteres, use a função Len.

Observação

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

Exemplo

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

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

• Funções (Visual Basic for Applications)

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.