Convenções de nomes e prefixos de tipos
Usa nomes que revelam intenção sem confundir prefixo com tipagem.
Visão geral
Prefixos como c, n, d, l, a, b e o ajudam a reconhecer texto, número, data, lógico, array, bloco e objeto em um padrão de equipe. São convenção de leitura, não uma declaração de tipo nem validação automática. Combine prefixo com intenção: nQuantidade informa mais que nValor1. Preserve identificadores definidos pelo Protheus e contratos externos; localizar variáveis autorais não autoriza renomear PARAMIXB ou campos do dicionário. O guia oficial de boas práticas fornece o contexto de padronização; o exemplo é uma proposta editorial pequena, sem impor uma única convenção a todos os projetos. (TOTVS, s.d., ref. 1)
Exemplo comentado
#Include "Protheus.ch"
User Function Ed315()
Local cResumo := "Teste"
Local nQuantidade := 2
Local lValidado := .T.
// O prefixo informa intencao; nao valida o valor.
If lValidado
ConOut(cResumo + ": " + cValToChar(nQuantidade))
EndIf
Return NilResumo fictício com quantidade 2. Em revisão: exemplo editorial não compilado nem executado em Protheus. Conferir includes, release, RDD e contexto antes de homologar.
- Evitar abreviações ambíguas e mudanças de tipo durante o fluxo. Documentar exceções impostas por API ou legado.
- Em revisão: exemplo editorial não compilado nem executado em Protheus. Conferir includes, release, RDD e contexto antes de homologar.
Comentários
Ainda não há comentários aprovados.
Entre com Google ou Microsoft para comentar.