Histórico da Página

...

Portuguese

Pagetitle

	Transform
	Transform

Colapse ALL

Expand ALL

Função: Transform

Converte

qualquer

valor

para

uma

string

formatada.

Para

isso,

formata

valores,

do

tipo

caracter,

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.

Sintaxe

Transform ( < xExp><xExp>, [ cSayPicture] ) --> Ret

Parâmetros/Elementos

Nome	Tipo	Descrição	Obrigatório	Referência
xExp	Qualquer	Indica o valor que será formatado. Esta expressão pode ser qualquer tipo de dado válido, exceto array, bloco de código e nulo.	X
cSayPicture	Caracter	Indica uma string de caracteres de máscara e template usada para descrever o formato da string que será retornada. Verificar Tabela de Pictures de Formatação	X

Retorno

Ret

Retorna a conversão da expressão (exp) para uma string formatada, conforme a definição do parâmetro cSayPicture.

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.
O funcionamento da Picture @E está relacionado com a configuração feita através da função __SetPicture.

Bloco de código

language	cpp
theme	Eclipse
title	Exemplo
linenumbers	true

Exemplos

nValue := 123.

45Transform

45
 
Transform(

nValue, "@E 999,999.99" )

 
// Resultado:"    123,45"

Abrangência

Advanced Protheus 6.09, Advanced Protheus 7.10, Microsiga Protheus 8.11

,

e Protheus 10

Veja Também

__SetPicture
Picture dos Campos - Dicionário de Dados
Tabela de Pictures de Formatação

Árvore de páginas

Versões comparadas

Versão antiga 1

Nova versão Atual

Chave

Função: Transform