Histórico da Página

Sintaxe

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

Propósito

Extrai uma parte de uma cadeia de caracteres a partir da sua última posição.

Argumentos

<expressão caracter>

Define a cadeia de caracteres da qual se deseja extrair uma parte à partir do final. 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 mais à direita. Ou seja, define o tamanho da parte que será extraída.

Utilização

A função RIGHT() permite extrair a última parte (parte mais à direita) 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( RIGHT("AdvPL", 4) )             // Fornece “dvPL”

Este exemplo extrai uma parte a partir do final de um string até a última ocorrência de uma vírgula:

LOCAL cName := "James, William"

MsgAlert( RIGHT(cName, LEN(cName) - RAT(",", cName) - 1) )  // Resulta: William