Histórico da Página

Sintaxe

LEFT( <expressão caracter>, <expressão numérica> )

Propósito

Extrai uma parte de uma cadeia de caracteres.

Argumentos

<expressão caracter>

Define a cadeia de caracteres da qual se deseja extrair uma parte. Esta cadeia poderá ter, no máximo, 64 Kbytes, ou seja, 65.535 caracteres.

<expressão numérica>

Define o número de caracteres a ser extraído da cadeia de caracteres especificada, iniciando-se do primeiro caracter. Ou seja, define o tamanho da parte que será extraída.

Utilização

A função LEFT() permite extrair a primeira parte (parte mais à esquerda) de uma cadeia de caracteres, com o número de caracteres especificado pela expressão numérica.

Se o resultado da expressão numérica for menor ou igual à zero, será fornecida uma cadeia de caracteres nula. Caso o resultado da expressão numérica seja maior que o tamanho total da cadeia de caracteres especificada, será fornecida toda a cadeia de caracteres.

Dicas

As funções LEFT(), RIGHT() e SUBSTR() são relacionadas, fornecendo partes extraídas de uma cadeia de caracteres especificada. A função LEFT() fornece a parte da esquerda, RIGHT() fornece a parte da direita e SUBSTR() fornece uma parte intermediária. Estas funções costumam ser utilizadas com as funções AT() e RAT(), que localizam a posição das partes a serem extraídas.

Através destas funções pode-se manipular qualquer cadeia de caracteres com no máximo 64 Kbytes de tamanho (65.535 posições).

Exemplos

MsgAlert( LEFT("AdvPL", 4) )             // Fornece “AdvP”

Este exemplo extrai uma parte a partir do início de um string até a primeira ocorrência de uma vírgula:

LOCAL cName := "James, William"

MsgAlert( LEFT(cName, AT(",", cName) - 1) )  // Resulta: James