TOTVSTEC

Árvore de páginas

Retorna um determinado número da caracteres à direita de uma string.

Sintaxe

Right( < cText >, < nCount > )

Parâmetros

Nome

Tipo

Descrição

Obrigatório

Referência

cText

caractere

Indica o texto que será tratado.

X

 

nCount

numérico

Indica o número de caracteres à direita a serem retornados.

X

 

Retorno

Nome

Tipo

Descrição

cRet

caractere

Retorna uma cópia da string, iniciando a partir do caractere final da string (último caractere da direita), considerando o número de caracteres especificado no segundo parâmetro.

Observações

  • Caso o parâmetro nCount seja maior que o tamanho da string, a string informada como parâmetro será retornada.
  • Caso o parâmetro nCount seja 0 (zero), a função retornará uma string vazia.
  • Caso o parâmetro nCount seja menor que 0 (zero), a função retornará um erro AdvPL com a mensagem "invalid len on right".

Exemplos

Exemplo 1
user function right1()
  Local cTest := "Linha para teste"
  
  conout( Right( cTest, 5 ) ) // Resultado: "teste"
return

Abrangência

Todas as versões

Veja também

  • Sem rótulos