Tempo de leitura: 3 minutos
No desenvolvimento Protheus, a conversão de tipos de dados é uma tarefa obrigatória. Muitas vezes precisamos exibir o conteúdo de uma variável numérica, lógica ou de data em uma mensagem para o usuário ou gravá-la em um arquivo de texto. A função cValToChar em ADVPL é a ferramenta mais versátil para isso, pois permite converter diversos tipos de dados para String de forma simplificada, sendo um pilar em Fundamentos do ADVPL.
Neste guia prático, você aprenderá a sintaxe da função cValToChar, suas vantagens sobre funções específicas e como utilizá-la em conjunto com funções de exibição como MsgInfo e MsgAlert.
O que é a função cValToChar e por que usá-la?
A função cValToChar (Value to Character) converte tipos de dados Numérico, Lógico ou Data para o tipo Caracter. A grande vantagem desta função é a sua “inteligência” em tratar diferentes tipos sem a necessidade de usar funções específicas para cada um, como a Str (para números) ou DToC (para datas).
Ela é ideal para:
Sintaxe:
cValToChar(xParam)
Parâmetro(s):
Retorno:
Exemplo:
cValToChar(100) -> “100”
No exemplo acima utilizamos a função cValToChar e informamos como parâmetro a função o valor numérico 100 e o retorno é uma caractere do número 100 igual a “100”.
Exemplo da função cValToChar em ADVPL:
#include 'protheus.ch'
/*{Protheus.doc} User Function fcValTCha
(Essa função tem por finalidade mostrar a função cValToChar em ADVPL)
@?type Function
@?author Adilio Costa
@?since 09/07/2023
@?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 fcValTCha()
//Variável cData recebendo o valor numérico 100
Local nNum := 100 //Variável númerica
Local lVar := .T. //Variável lógica
Local dData := DATE() //Variável data
Local cCarac := 'ProtheusAdvpl'
Local cMsg:=""
cMsg += "O valor numérico 100 convertido para String é:"+cValToChar(nNum)+CHR(13)
cMsg += "O valor lógico .T. convertido para String é:"+cValToChar(lVar)+CHR(13)
cMsg += "O valor data DATE() convertido para String é:"+cValToChar(dData)+CHR(13)
cMsg += "O valor caractere 'ProtheusAdvpl' convertido para String é:"+cValToChar(cCarac)
MsgInfo(cMsg,"Função cValToChar")
Return
No vídeo abaixo temos um exemplo da função cValToChar em ADVPL:
Domine a Programação ADVPL do Zero ao Profissional
Para dominar este conceito em cenários complexos, como a criação de interfaces dinâmicas, tratamento de retornos de APIs e manipulação avançada de strings, conheça o Portal ProtheusAdvpl. Lá, exploramos a fundo a arquitetura do Protheus e as melhores práticas de codificação.
Cursos Recomendados:
Conclusão
A função cValToChar em ADVPL é uma das funções mais úteis para o dia a dia do desenvolvedor Protheus. Ela traz agilidade na Conversão de Dados e reduz a complexidade do código. Dominar o uso desta função em conjunto com MsgInfo e outras funções de interface é essencial para criar rotinas profissionais.
Links de referência(s):
