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, 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 número de carateres na cadeia, é devolvida toda a cadeia. |
Comentários
Para determinar o número de carateres na cadeia, utilize a função Núm. carat.
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".