Função esquerda
Retorna uma Variant (Cadeia de Caracteres) que contém um número especificado de caracteres do lado esquerdo de uma cadeia de caracteres.
Sintaxe
Esquerda(cadeia de caracteres, comprimento)
A sintaxe da função esquerda 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 | Necessário; Variant (Long). Expressão numérica que indica quantos caracteres devem ser retornados. Se 0, uma cadeia de caracteres 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
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.