Macros et préprocesseur » Historique » Version 1
Patrice Nadeau, 2024-01-27 14:28
| 1 | 1 | Patrice Nadeau | # Macros |
|---|---|---|---|
| 2 | |||
| 3 | ## Règles |
||
| 4 | 1. Comportent au maximum 31 caractères |
||
| 5 | 1. Commence par une lettre |
||
| 6 | 1. Si plusieurs mots sont utilisés, ils sont séparées par des traits de soulignement |
||
| 7 | 1. Les macros ne devant plus être utilisées, DOIVENT générer un message lors de la compilation avec `#pragma GCC poison` |
||
| 8 | > Dans ce cas, la documentation doit indiquer le substitut à utiliser |
||
| 9 | > Pour la définition d’une valeur entière signée (int), un enum DOIT être utilisé. |
||
| 10 | |||
| 11 | ## Exemple |
||
| 12 | ```c |
||
| 13 | /** |
||
| 14 | * @brief MACRO1 |
||
| 15 | * @deprecated Utiliser NEWMACRO à la place |
||
| 16 | * @since Version x.x.xx |
||
| 17 | */ |
||
| 18 | #define MACRO1 43 |
||
| 19 | #pragma GCC poison MACRO1 |
||
| 20 | ``` |
||
| 21 | |||
| 22 | ## Justification |
||
| 23 | • Linux kernel coding style4 |
||
| 24 | • GNU Coding Standards5 |
||
| 25 | • Embedded C Coding Standard6 |
||
| 26 | • Correspondance avec la fiche technique (datasheet) |