FUNçãOEm revisão

ValType

ValType( <xValor> )

Retorna o tipo do valor recebido como parâmetro.

Tipos de dadosVariáveisVerificação

01 · VISÃO GERAL

Visão geral

ValType() identifica o tipo de um valor ou variável já disponível no escopo da função. É mais direta que Type() quando o valor pode ser passado como argumento, sendo útil para validações defensivas e rotinas genéricas.

02 · SINTAXE

Sintaxe

ValType( <xValor> )

Parâmetros

xValor

QualquerObrigatório

Valor cujo tipo será consultado.

03 · EXEMPLO PRÁTICO

Validação simples de tipo

User Function ExValType()
    Local xValor := Date()

    If ValType(xValor) == "D"
        MsgInfo("Data informada: " + DToC(xValor))
    EndIf
Return

Resultado esperado

A rotina confirma que o valor é data antes de formatá-lo.

BOAS PRÁTICAS

Os retornos seguem os identificadores de tipo da linguagem, como C, N, D, L, A, B, O e U.
Use em funções que aceitam valores flexíveis e precisam validar a entrada.

ARMADILHAS COMUNS

Não basta verificar o tipo; valide também conteúdo, tamanho e faixa de valores.
Evite fluxos excessivamente genéricos quando a regra poderia declarar melhor o contrato esperado.

Conteúdos relacionados

REFERÊNCIAS

Programação em ADVPL Completo. Documentação oficial histórica de treinamento, seção 4.5.4, p. 45-50. Conteúdo resumido, revisado e exemplos adaptados.

Situação: Em revisão
Página criada em: 24/08/2026 às 23:20
Última revisão em: 24/08/2026 às 23:20
Idioma original: Português
Revisão: Usina.BR