Usina BRAdvPL Guia
Entrar
← Todos os tópicos
FUNçãOEm revisão

TRANSFORM()

Transform(xValue,cPicture) -> cText

Formata uma expressão usando uma máscara.

TRANSFORM()AdvPL
01 · VISÃO GERAL

Visão geral

Transform recebe expressão escalar e picture, gerando texto de apresentação. Não valida documento, autorização ou cálculo financeiro. O exemplo usa @! para converter letras em maiúsculas e evita dependência de separador decimal. Máscaras numéricas exigem conferir largura, arredondamento e configuração; @E pode ser influenciado por __SetPicture conforme o TDN. (Fontes: refs. 1–2.)

02 · SINTAXE

Sintaxe

Transform(xValue,cPicture) -> cText

Parâmetros

xValue
EscalarObrigatório

Caractere, data, lógico ou numérico suportado.

cPicture
CaractereObrigatório

Máscara de apresentação.

Retorno

Caractere.

03 · EXEMPLO PRÁTICO

Exemplo comentado

#Include "Protheus.ch"

User Function Ed694()
    // Mascara de apresentacao, sem validar o conteudo.
    ConOut(Transform("edicao","@!"))
Return Nil
Resultado esperado

Exibe EDICAO. Em revisão: exemplo editorial não compilado nem executado em Protheus. Conferir includes, release, RDD e contexto antes de homologar.

BOAS PRÁTICAS
  • Não converter texto formatado de volta a número sem um contrato de formato.
  • Em revisão: exemplo editorial não compilado nem executado em Protheus. Conferir includes, release, RDD e contexto antes de homologar.

Conteúdos relacionados

REFERÊNCIAS
  1. TOTVS. Transform. Sintaxe e observações. TDN. Consulta em 2026-10-28.
  2. Atilio. dan-atilio/AdvPL. Maratona de Exemplos/Exemplo_503_Funcao_Transform.prw. Arquivo completo consultado; adaptação editorial. Consulta em 2026-10-28.
Situação
Em revisão
Página criada em
Última revisão em
Idioma original
Português
Revisão
Usina.BR
0 comentário(s) aprovado(s)

Comentários

Ainda não há comentários aprovados.

Entre com Google ou Microsoft para comentar.

Powered by Usina Docs · Alpha