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

Comentários, continuação de linha e formatação do fonte

Organiza o código para tornar intenção e sequência legíveis.

Comentários, continuação de linha e formatação do fonteAdvPL
01 · VISÃO GERAL

Visão geral

A estrutura AdvPL separa declarações, comandos, funções, diretivas e comentários. Indentação ajuda a ler os blocos, mas não substitui delimitadores como EndIf. Use comentários para explicar condições e motivo das decisões. Uma expressão longa pode continuar na linha seguinte com ponto e vírgula no final da linha anterior; mantenha a continuidade explícita e confira o resultado da compilação. O exemplo soma valores em duas linhas e comenta o limite da proposta: uma conta didática, sem regras monetárias de arredondamento. (TOTVS, s.d., refs. 1–2)

03 · EXEMPLO PRÁTICO

Exemplo comentado

#Include "Protheus.ch"
User Function Ed305()
    Local nTotal := 0
    // Soma didatica: valores conhecidos e sem persistencia.
    nTotal := 10 + ;
              20
    ConOut(cValToChar(nTotal))
Return Nil
Resultado esperado

Resultado esperado: 30. Em revisão: exemplo editorial não compilado nem executado em Protheus. Conferir includes, release, RDD e contexto antes de homologar.

BOAS PRÁTICAS
  • Evitar comentários contraditórios com o código e blocos extensos de código morto. Preservar avisos de autoria e dependências; revisar comentários em cada idioma.
  • 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. Introdução / Estrutura da Linguagem. TDN. Consulta em 2026-10-26.
  2. TOTVS. Guia de Boas Práticas - ADVPL. 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