Usina BRAdvPL Guia
Entrar
← Todos os tópicos
COMANDOEm revisão

DEFAULT

DEFAULT xParametro := xValor

Fornece valor padrão a um parâmetro não informado.

DEFAULTAdvPL
01 · VISÃO GERAL

Visão geral

DEFAULT é a forma tradicional de atribuir um valor quando o parâmetro está Nil; zero, falso e texto vazio não são sinônimos de ausência. O exemplo define padrão e depois valida tipo, pois DEFAULT não valida um argumento fornecido. A documentação atual apresenta FWADVPLDEFAULT para parâmetros AdvPL e distingue FWDEFAULT/FWNULLDEFAULT em TLPP. Essas formas exigem Protheus.ch atualizado, parâmetro previamente declarado e uso individual; não presumir disponibilidade em includes antigos nem usar para criar Private. (TOTVS, s.d., refs. 1–2)

02 · SINTAXE

Sintaxe

DEFAULT xParametro := xValor

Parâmetros

xParametro
QualquerObrigatório

Parâmetro já declarado na função.

xValor
QualquerObrigatório

Valor padrão compatível com o contrato.

Retorno

Comando de atribuição condicional; não é uma função com retorno próprio.

03 · EXEMPLO PRÁTICO

Exemplo comentado

#Include "Protheus.ch"
User Function Ed346(nValor)
    // Zero informado continua zero; argumento omitido recebe 10.
    Default nValor := 10
    If ValType(nValor) <> "N"
        Return Nil
    EndIf
Return nValor * 2
Resultado esperado

U_Ed346() retorna 20; U_Ed346(0) retorna 0; texto retorna Nil após validaçã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
  • Distinguir valor ausente de valor inválido. A escolha entre macros atuais deve respeitar linguagem, tipos e include efetivamente disponível.
  • 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. Default de Parâmetros de Função. TDN. Consulta em 2026-10-26.
  2. TOTVS. Defaults - ADVPL e TLPP. TDN. Consulta em 2026-10-26.
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