FUNçãOEm revisão

Rat

Rat( <cCaractere>, <cString> )

Retorna a última posição de um texto dentro de outra string.

StringsPesquisaTexto

01 · VISÃO GERAL

Visão geral

Rat() faz uma busca textual semelhante a At(), mas retorna a última ocorrência encontrada. É útil para separar extensão de arquivo, localizar o último separador de caminho ou tratar textos com múltiplas ocorrências.

02 · SINTAXE

Sintaxe

Rat( <cCaractere>, <cString> )

Parâmetros

cCaractere

CaractereObrigatório

Caractere ou trecho procurado.

cString

CaractereObrigatório

Texto onde a busca será realizada.

03 · EXEMPLO PRÁTICO

Obtendo extensão de arquivo

User Function ExRat()
    Local cArquivo := "relatorio.final.pdf"
    Local nPonto := Rat(".", cArquivo)

    If nPonto > 0
        MsgInfo("Extensão: " + SubStr(cArquivo, nPonto + 1))
    EndIf
Return

Resultado esperado

Rat() localiza o último ponto e permite extrair a extensão pdf.

BOAS PRÁTICAS

Use At() quando quiser a primeira ocorrência.
Combine com SubStr() para extrair a parte final de um texto.

ARMADILHAS COMUNS

Trate o caso em que a ocorrência não foi encontrada.
Padronize maiúsculas/minúsculas quando a busca não deve depender da caixa do texto.

Conteúdos relacionados

REFERÊNCIAS

Programação em ADVPL Completo. Documentação oficial histórica de treinamento, seção 4.5.4, p. 45-50. Conteúdo resumido, revisado e exemplos adaptados.

Situação: Em revisão
Página criada em: 24/08/2026 às 23:20
Última revisão em: 24/08/2026 às 23:20
Idioma original: Português
Revisão: Usina.BR