AplicaMascara

A função AplicaMascara recebe uma máscara e um valor e retorna o valor com a máscara aplicada. É especialmente útil na geração de arquivos TXT com layout específico e também em relatórios cWinReport2 ou BasicReport para aplicar máscara em campos na impressão.

Tipo de Retorno

String

Pacote

A função AplicaMascara está definida dentro do pacote AplicaMascara.pkg.

Sintaxe

Move (AplicaMascara({sMascara},{sValor})) to {sResultado} 

Onde:

  • {sMascara} é a máscara que será aplicada, sendo que um caracter "x" indica que um caracter de {sValor} será usado naquela posição, e qualquer outro caractere que não seja um "x" será devolvido ao final pela função na sua posição;
  • {sValor} é o valor que será mascarado, e se for passada uma variável não string seu conteúdo será convertido como string e tratado como tal;
  • {sRet} é a variável que receberá o retorno da função.

Exemplo

Move (AplicaMascara("xxx.xxx.xxx-xx",Usuario.sCPF)) to sCPFMascarado

Observações

  • Ao informar como máscara o valor "xxx.xxx.xxx-xx" e como valor "99999999999", o resultado devolvido será "999.999.999-99".

Tópicos relacionados