Ícone do site Embarcadero RAD Studio, Delphi, & C++Builder Blogs

Novo Guia de Estilo Pascal de Objetos do Delphi

lightide

A Embarcadero acaba de publicar no site docwiki uma versão atualizada do guia de estilo de linguagem. O documento foi atualizado para cobrir os recursos modernos da linguagem Delphi e algumas mudanças no estilo de codificação

Nos últimos meses, fiz um esforço para publicar um novo guia de estilo Object Pascal para a linguagem Delphi de hoje. Do prefácio:

“Este documento é uma versão atualizada do guia de estilo clássico Object Pascal, originalmente com curadoria de Charlie Calvert para a Borland na época em que o Delphi foi originalmente lançado. A versão atualizada foi selecionada pelo gerente de produto da Delphi, Marco Cantu, com contribuições da equipe interna de P&D, MVPs da Delphi e da comunidade Delphi em geral. ”

O texto não é um guia de linguagem, em vez disso, cobre o uso de espaços em branco e formatação ao escrever o código – algo que o compilador geralmente ignora. Nada é obrigatório aqui, esta é apenas uma recomendação para favorecer a legibilidade. Seguir essas regras é um requisito para nossa própria equipe interna e para qualquer colaborador.

Você pode encontrar o guia de estilo em  http://docwiki.embarcadero.com/RADStudio/Sydney/en/Delphi’s_Object_Pascal_Style_Guide  .
Este é o índice do documento:

Vou terminar este blog postando uma breve introdução:

Enquanto os compiladores Delphi geralmente ignoram qualquer espaço em branco e permitem muita flexibilidade na forma como um desenvolvedor escreve o código, para legibilidade e manutenção do código-fonte, a Embarcadero definiu um conjunto de diretrizes usadas pelo P&D interno e qualquer desenvolvedor envolvido com o projeto. Recomendamos que a comunidade Delphi em geral adote esse estilo de codificação e formatação.

A introdução da versão original deste documento expressa isso muito bem:

“Object Pascal é uma linguagem lindamente projetada. Uma de suas grandes virtudes é a legibilidade. Esses padrões são projetados para melhorar a legibilidade do código Object Pascal. Quando os desenvolvedores seguem as convenções simples apresentadas neste guia, eles estão promovendo padrões que beneficiam todos os desenvolvedores Delphi, usando um estilo uniforme e fácil de ler. Os esforços para fazer cumprir esses padrões aumentarão o valor do código-fonte do desenvolvedor, especialmente durante os ciclos de manutenção e depuração. ”
Este documento não faz referência ou explica a sintaxe e a gramática da linguagem, pois se concentra apenas na definição do estilo de escrita do código em locais onde a linguagem oferece uma escolha, permitindo muitas opções diferentes em termos de espaço em branco e formatação.

Nenhuma dessas diretrizes é imutável e esperamos que evoluam com o tempo junto com a linguagem.

Sair da versão mobile