Tempo de leitura: 3 minutos
A função Chr() no ADVPL é um recurso simples, mas muito útil no desenvolvimento para Protheus. Ela permite converter um código numérico em caractere e aparece com frequência em situações como montagem de mensagens, tratamento de strings e inserção de quebra de linha.
Se você já precisou exibir um texto em mais de uma linha dentro de uma rotina, entender o uso de Chr(13) e Chr(10) pode facilitar bastante a implementação.
O que é a função Chr
A função Chr() retorna um caractere a partir de um código numérico.
Na prática, ela é muito usada quando precisamos trabalhar com texto de forma controlada, principalmente em cenários como:
- mensagens exibidas ao usuário
- composição de textos dinâmicos
- organização de strings
- inserção de caracteres especiais
- quebra de linha em alertas e rotinas
No contexto do ADVPL, essa função é muito útil porque ajuda a estruturar melhor a saída visual de mensagens e conteúdos textuais.
Sintaxe:
Chr(nCodAsc)
Parâmetro(s):
Retorno:
Exemplo da função Chr em ADVPL:
#include 'protheus.ch'
#include 'rwmake.ch'
#INCLUDE "TBICONN.CH"
/*{Protheus.doc} User Function fChr
(Essa função tem por finalidade mostrar a função Chr em ADVPL)
@type Function
@author Adilio Costa
@since 13/01/2025
@version 1.0
@?Inscreva-se no Blog ProtheusAdvpl:
https://www.protheusadvpl.com.br
@?Inscreva-se no Canal ProtheusAdvpl:
https://www.youtube.com/protheusadvpl
@?Siga-nos no Instagram:
https://www.instagram.com/protheusadvpl
@?Conheça os Cursos e Formações do ProtheusAdvpl:
https://cursos-e-formacoes-protheusadvpl.gr-site.com/
|Se esse conteúdo foi útil pra você nos ajude divulgando
ele e nossas redes sociais!!|
*/
User Function fChr()
Local nCodAsc1 := 10
Local nCodAsc2 := 13
FWAlertInfo("Aqui utilizamos a função Chr para definir "+Chr(nCodAsc1)+Chr(nCodAsc2)+" uma quebra de linha(enter) em ADVPL.","Função Chr")
Return
Quando usar Chr na prática
A função Chr() é útil quando você precisa:
- inserir quebras de linha em mensagens
- formatar textos exibidos em alertas
- montar conteúdo dinâmico em variáveis de string
- organizar saídas em relatórios ou logs
- tratar caracteres de controle em rotinas ADVPL
Em outras palavras, é uma função simples, mas que resolve bem situações comuns em programação para Protheus.
Cuidados e observações
Embora seja uma função direta, vale observar alguns pontos:
- a função trabalha com códigos numéricos
- a combinação de caracteres pode variar conforme o contexto da saída
- é importante testar o resultado visual no ambiente real do Protheus
- quando o objetivo for apenas exibir texto, mantenha a estrutura da string clara e objetiva
Esses cuidados ajudam a evitar comportamento inesperado na apresentação das mensagens.
Referência oficial
A documentação oficial da TOTVS para a função pode ser consultada aqui:
Esse link é importante porque:
- valida o comportamento da função
- complementa o entendimento técnico
- reforça a credibilidade do conteúdo
- ajuda o leitor que quer ir direto à fonte oficial
Conclusão
A função Chr() é simples, mas extremamente útil no ADVPL.
Ela aparece com frequência em rotinas que precisam manipular texto, inserir caracteres especiais ou organizar mensagens com quebra de linha.
Se você desenvolve para Protheus, vale manter esse recurso na sua base de conhecimento, porque ele resolve com elegância situações bem comuns do dia a dia.
Leitura recomendada
Confira também:
