Have an amazing solution built in RAD Studio? Let us know. Looking for discounts? Visit our Special Offers page!
Nouvelles

Nouveau guide de style Object Pascal de Delphi

lightide

Embarcadero vient de publier sur le site docwiki une version mise à jour du guide de style de langue. Le document a été mis à jour pour couvrir les fonctionnalités du langage Delphi moderne et certaines modifications du style de codage

Au cours des derniers mois, je me suis efforcé de publier un nouveau guide de style Object Pascal pour le langage Delphi actuel. De la préface:

¬ęCe document est une version mise √† jour du guide de style Object Pascal classique, initialement organis√© par Charlie Calvert pour Borland au moment de la sortie de Delphi.¬†La version mise √† jour a √©t√© organis√©e par Marco Cantu, chef de produit Delphi, avec les contributions de l’√©quipe R&D interne, des MVP Delphi et de la communaut√© Delphi dans son ensemble. ¬Ľ

Le texte n’est pas un guide de langage, il couvre plut√īt l’utilisation des espaces blancs et le formatage lors de l’√©criture de code – ce que le compilateur ignore g√©n√©ralement.¬†Rien n’est obligatoire ici, c’est juste une recommandation pour favoriser la lisibilit√©.¬†Le respect de ces r√®gles est une exigence de notre propre √©quipe interne et de tout contributeur.

Vous pouvez trouver le guide de style sur¬†¬†http://docwiki.embarcadero.com/RADStudio/Sydney/en/Delphi’s_Object_Pascal_Style_Guide¬†¬†.
Voici l’index des documents:

  • introduction
  • R√®gles g√©n√©rales: identifiants, mots cl√©s, indentation
  • Fichiers de code source, unit√©s et leur structure
  • Utilisation de l’espace blanc
  • commentaires
  • D√©clarations
  • D√©clarations de type

Je terminerai ce blog en publiant la courte introduction:

Alors que les compilateurs Delphi ignorent g√©n√©ralement tout espace blanc et permettent une grande flexibilit√© dans la fa√ßon dont un d√©veloppeur √©crit le code, pour la lisibilit√© et la maintenabilit√© du code source, Embarcadero a d√©fini un ensemble de directives utilis√©es par la R&D interne et tout d√©veloppeur impliqu√© dans le projet.¬†Nous recommandons √† la communaut√© Delphi dans son ensemble d’adopter ce style de codage et de formatage.

L’introduction de la version originale de ce document l’exprime bien:

¬ęObject Pascal est un langage magnifiquement con√ßu.¬†Une de ses grandes vertus est sa lisibilit√©.¬†Ces normes sont con√ßues pour am√©liorer la lisibilit√© du code Object Pascal.¬†Lorsque les d√©veloppeurs suivront les conventions simples √©nonc√©es dans ce guide, ils feront la promotion de normes qui profiteront √† tous les d√©veloppeurs Delphi en utilisant un style uniforme et facile √† lire.¬†Les efforts visant √† appliquer ces normes augmenteront la valeur du code source d’un d√©veloppeur, en particulier pendant les cycles de maintenance et de d√©bogage. ¬Ľ
Ce document ne fait pas r√©f√©rence ni n’explique la syntaxe et la grammaire du langage, car il se concentre uniquement sur la d√©finition du style d’√©criture de code dans les endroits o√Ļ la langue vous donne le choix, en permettant de nombreuses options diff√©rentes en termes d’espaces blancs et de formatage.

Aucune de ces lignes directrices n’est grav√©e dans le marbre et nous nous attendons √† ce qu’elles √©voluent avec le temps avec la langue.


Reduce development time and get to market faster with RAD Studio, Delphi, or C++Builder.
Design. Code. Compile. Deploy.
Start Free Trial   Upgrade Today

   Free Delphi Community Edition   Free C++Builder Community Edition

Leave a Reply

Ce site utilise Akismet pour réduire les indésirables. En savoir plus sur comment les données de vos commentaires sont utilisées.

IN THE ARTICLES