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 cadeia contiver Nulo, Nulo é devolvido. |
| comprimento | Obrigatório. Variante (Longo). expressão numérica que indica o número de carateres a devolver. Se for 0, será devolvida uma cadeia de comprimento zero (""). Se for maior ou igual ao numero de carateres na cadeia, é devolvida toda a cadeia. |
Observações
Para determinar o número de carateres na cadeia, utilize a função Compr .
Nota
Utilize a função EsquerdaB com dados de byte contidos numa cadeia. Em vez de especificar o número de carateres a devolver, comprimento especifica o número de bytes.
Exemplo de consulta
| Expressão | Resultados |
|---|---|
| SELECT Left(IDDoProduto,3) COMO FromLeft FROM ProductSales; | Devolve os carateres '3' do lado esquerdo dos valores no campo "IDDoProduto" da tabela "VendasDoProduto" na coluna FromLeft. |
Exemplo do 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".