Tempo de leitura: 1 minuto
A função Transform converte qualquer valor para uma string formatada. Para isso, formata valores do tipo caractere, data, lógico e numérico, conforme uma string de máscara especificada que inclui uma combinação de strings de template e funções de picture. Ela é uma das funções de manipulação de string em ADVPL.
Sintaxe:
Transform(xExp,cMasc)
Parâmetro(s):
Retorno:
Observações:
-
Esta função tem a mesma característica, do parâmetro PICTURE, do comando @…SAY;
-
Utilizada para formatar dados que serão enviados à tela ou à impressora.
Exemplo de Transform em ADVPL:
#include 'protheus.ch'
/*{Protheus.doc} User Function PATransf
(Essa função tem por finalidade mostrar a função de Manipulação de String Transform em ADVPL)
@type Function
@author Adilio Costa
@since 09/01/2024
@version Protheus 12.1.2210
@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 do ProtheusAdvpl:
https://hotmart.com/pt-br/club/protheusadvpl
|Se esse conteúdo foi útil pra você nos ajude divulgando
ele e nossas redes sociais!!|
*/
User Function PATransf()
Local nNum := 48905.40
Local cCel := "85988887777"
Local cCEP := "61920888"
Local cMascNum := "@E 999,999,999.99"
Local cMascCel := "@R (99) 9 9999-9999"
Local cMascCEP := "@R 99999-999"
Local cTransfNum
Local cTransfCel
Local cTransfCEP
Local cMsg := ""
cTransfNum := Transform(nNum,cMascNum) //48.905,40 ->Número formatado
cTransfCel := Transform(cCel,cMascCel) //(85) 9 8888-7777 ->Celular formatado
cTransfCEP := Transform(cCEP,cMascCEP) //61920-000 ->CEP formatado
cMsg := "O número "+cValToChar(nNum)+" transformado é:"+cTransfNum+Chr(10)+Chr(13)
cMsg += "O celular "+cValToChar(cCel)+" transformado é:"+cTransfCel+Chr(10)+Chr(13)
cMsg += "O CEP "+cValToChar(cCEP)+" transformado é:"+cTransfCEP
MsgInfo(cMsg,"Função Transform")
Return
No código ADVPL acima utilizamos a função Transform para formatar número, celular e CEP:
É isso aí, finalizamos mais um post aqui no Blog ProtheusAdvpl. Caso tenha ficado alguma dúvida deixe seu comentário ou nos envie um e-mail para adiliocosta@protheusadvpl.com.br, até um próximo post, grande abraço e fica com Deus.
Link(s) de referência(s):
