Histórico da Página
Incluir 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