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

ValType

ValType( <xParam> ) --> cRet

Identifica o tipo do valor recebido.

ValTypeAdvPL
01 · VISÃO GERAL

Visão geral

ValType recebe o valor e devolve um código caractere: A para array, B para bloco, C para caractere, D para data, L para lógico, N para numérico, O para objeto e U para não definido/Nil. A referência também relaciona F para decimal de ponto fixo; confirme sua disponibilidade no ambiente. Não confundir com Type, que trabalha com uma expressão em texto. Verificar o tipo não valida tamanho de array, conteúdo ou propriedades de objeto. (Ref. 1)

02 · SINTAXE

Sintaxe

ValType( <xParam> ) --> cRet

Parâmetros

xParam
QualquerObrigatório

Valor cujo tipo será identificado.

Retorno

Caractere identificador do tipo do valor.

03 · EXEMPLO PRÁTICO

Exemplo comentado

#Include "TOTVS.ch"

User Function EdTipo()
    Local uValor := Nil
    // Nil e um valor definido na variavel, com codigo U.
    ConOut(ValType(uValor))
    uValor := {"A", "B"}
    If ValType(uValor) == "A"
        // O tipo nao comprova quantos elementos existem.
        ConOut(cValToChar(Len(uValor)))
    EndIf
Return Nil
Resultado esperado

Resultados esperados: U e 2. A variável existe desde sua declaração. 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 avaliar identificadores inexistentes para testar sua existência. Declarar a variável e validar também a estrutura necessária antes de indexar arrays.
  • 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. ValType. TOTVSTEC/TDN. Consulta em 2026-10-24.
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