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, será devolvido Nulo. |
| comprimento | Obrigatório. Variante (Longo). expressão numérica que indica quantos carateres pretende 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. |
Observações
Para determinar o número de carateres na cadeia, utilize a função Len .
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, 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".