Règles de codage C¶

Le langage C utilisé avec le compilateur GCC :

• Standard C99 (-std=c99)
• Extensions GNU
  • attribute((deprecated)) (-Wdeprecated-declaration)
  • attribute((noreturn))
  • #pragma GCC message ""
  • #pragma GCC warning ""
  • #pragma GCC error ""

TODO : static & const

• Contenu
• Règles de codage C
  • Style
  • Identifiants
  • Fichiers
  • Fichiers sources
  • Commentaires
  • Macros et préprocesseur
  • Énumérations
  • Typedef
  • Structures
  • Fonctions

Style¶

1. DOIT être de style Allman
2. L’indentation DOIT être de 4 espaces
3. Une ligne ne DOIT PAS avoir plus de 80 caractères

   La barre oblique inversée DOIT être utilisée dans les longues chaine de caractères (string)

4. Une instruction par ligne
5. Une espace avant et après un opérateur DOIT être utilisée sauf pour les opérateurs unaires
6. L’opérateur ternaire ?: ne DOIT PAS être utilisé
7. La constante DOIT être placée à la gauche de l’opérateur d’équivalence (==)

   Prévient les erreurs lors d'ajout dans les blocs d'une seule instruction

Identifiants¶

1. Ne DOIT PAS contenir plus de 31 caractères

   ANSI standards

   • a @ z
   • A @ Z
   • 0 @ 9
   • Trait de soulignement (__)

2. En anglais américain :

   • Lettres
     • Macros :
       • Majuscules et minuscules

         La parie principale DOIT être en majuscule

     • Fonctions, variables, énumérations, structures, définition de type :
       • Minuscules
   • Nombre
   • Commence par une lettre
   • Si plusieurs mots sont utilisés, ils DOIVENT être séparées par des traits de soulignement

3. Déclaration

   1. Un objet ayant une visibilité locale DOIT avoir le modificateur static
   2. Un objet « obsolète », DOIT avoir :
      1. Un des attributs :

         Génération de message lors de la compilation (-Wall)

         • deprecated
         • unavailable
      2. Les commentaires Doxygen :
         • @deprecated : Indications sur le remplacement à utiliser
         • @since : Depuis quel version le changement est apparue

Fichiers¶

Structure des répertoires et fichiers

Format selon la commande tree --charset ascii

.
|-- AUTHORS : Fichier contenant les noms et courriels des auteurs
|-- bin : Répertoire contenant le fichier exécutable et les librairies compilées
|-- ChangeLog : Fichier des changements
|-- config.h : Fichier optionel contenant les macros communes au programme dans son ensemble (-imacros)
|-- COPYING : Fichier de licence (standard GNU)
|-- docs : Répertoire de la documentation (.pdf)
|-- include : Répertoire des fichiers d’en-tête (.h)
|-- INSTALL
|-- lib : Répertoire des libraires externes (liens symboliques)
|-- Makefile.in : Fichier d'informations spécifiques du projet pour le Makefile
|-- NEWS :
|-- obj : Répertoire contenant les objets (.o)
|-- README : Fichier d'informations du projet, en format markdown
`-- src : Répertoire des fichiers sources (.c)

Fichiers sources¶

1. Nom du fichier :
   • Un préfixe en anglais de 8 caractères maximum pouvant contenir :
     • Lettres minuscule
     • Chiffres
     • Trait de soulignement
   • DOIT contenir un des suffixe suivants :
     • .h : entête
     • .c : sources
2. Contenus
   • Section Doxygen :
     1. @file : Le nom du fichier
     2. @brief: Une brève description
     3. @version: Le numéro de version
     4. @date: La date de dernière modification
     5. @author: Une liste des participant(e)s et leur courriel
     6. @copyright: La liste des années et participant(e)s
   • Les fichiers d’entête contiennent en plus
     1. Une définition macro pour éviter de ré-inclure le fichier (https://fr.wikipedia.org/wiki/Include_guard).

Style

Commentaires¶

1. Précède l’élément à documenté, avec la même indentation
2. En minuscules et commence par une majuscule
3. Phrase complète en français
4. Sur une ou plusieurs lignes
5. De style C (/*... */)
6. Doxygen DOIT aussi être utilisé
   1. Les « décorations » (gras, italique, etc.) sont faites avec la syntaxe Markdown

Macros et préprocesseur¶

Directives du préprocesseur gcc.

1. Les macros ne devant plus être utilisées, DOIVENT générer un message lors de la compilation avec #pragma GCC poison

   Dans ce cas, la documentation doit indiquer le substitut à utiliser
   Pour la définition d’une valeur entière signée (int), un enum DOIT être utilisé.

2. Définition conditionnel : Utiliser une forme évitant les répétitions.

3. Macros #warning et #error : Utilisées pour afficher des avertissements ou des erreurs lors de la compilation.

   N’est pas documenté dans Doxygen.

4. Un #define est utilisé pour remplacer une valeur au moment de la compilation

   Pour la définition d'une valeur « integer », un enum DOIT être utilisé.

Énumérations¶

DOIT être utilisée pour définir une série de valeurs.

• Permet l’utilisation dans une boucle avec des valeurs prédéfinis

Typedef¶

1. En minuscule
2. Suivie de _t

Variables

Structures¶

/**
* @brief Structure d'un menu local
* @sa MenuSelect
*/
struct menu {
/** @brief Caractère utilisé pour l'item */
char choice;
/** @brief Description de l'item */
char *item;
};

Fonctions¶

Les fonctions définies dans une librairie de bas niveau pour du matériel (« driver ») DEVRAIENT utiliser les noms définis dans la fiche technique.

1. Le nom DOIT être dans le format suivant : module_action_attribut
   1. module signifie
      • Le nom d'un objet ou de la librairie
   2. action signifie :
      • set, get, clear : Règle, obtient ou vide un registre
      • read, write : Lis ou écris dans un fichier
      • init : Fonction d’initialisation
      • is : Vérifie un état
      • setup : Fonction de configuration des ports (p. ex. : AVR)
   3. attribut signifie

      TODO

2. Le modificateur static DOIT être utilisé dans la déclaration d’une fonction avec une vue locale
3. DOIT contenir qu’un seul return

Atmel AVR