star-style

Writing conventions for co-authors
Log | Files | Refs | README | LICENSE

commit 6f131fe9dc483bafa7960adcaff8fce5e9963688
parent 664ce75d4abb94fce1efa1e2c78df15b896b960b
Author: Vincent Forest <vincent.forest@meso-star.com>
Date:   Thu, 16 Jul 2026 09:59:38 +0200

Mise à jour des sections sur les constantes et structures

Déplace dans cette dernière la définition des constantes utilisées pour
initialiser une structure.

Diffstat:
Mdoc/fr/star-c.7 | 45++++++++++++++++++---------------------------
1 file changed, 18 insertions(+), 27 deletions(-)

diff --git a/doc/fr/star-c.7 b/doc/fr/star-c.7 @@ -1244,32 +1244,6 @@ static const char* NOM_DES_MOLECULES[NOMBRE_DE_MOLECULES] = { "CH4", "CO", "CO2", "H2O", "N2O", "O3" }; .Ed -.Pp -Définir les valeurs par défaut d'une structure à l'aide d'une variable -constante du type concerné, déclarée en tant que variable statique. -Et une macro qui liste ses valeurs par défaut, utilisé pour initialiser -ladite variable : -.Bd -literal -offset Ds -struct foo { - float bar; - int baz; -}; -#define FOO_DEFAULT__ {-1,0} -static const struct foo FOO_DEFAULT = FOO_DEFAULT__; -.Ed -.Pp -N'utiliser la macro que lorsqu'il est impossible d'utiliser la variable -constante, en l'occurence pour initialiser, dès sa définition, les -membres d'une variable structurée : -.Bd -literal -offset Ds -struct qux { - struct foo foo; - double - int quux; -}; -#define QUX_DEFAULT__ {FOO_DEFAULT__, 0} -static const struct qux QUX_DEFAULT = QUX_DEFAULT__; -.Ed .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .Sh LES STRUCTURES Définir les structures en en-tête de fichier @@ -1292,7 +1266,12 @@ Suffixer cette constante par ou .Ql NULL fonction de si une variable structurée ainsi initialisée est une donnée -valide ou non : +valide ou non. +Déclarer cette constante en tant que variable statique et l'initialiser par +une macro de même nom, différencié de la variable constante par un +double tiret bas final +.Ql __ Ns + : .Bd -literal -offset Ds struct arg { char* fichier; /* NULL <=> entrée standard */ @@ -1310,6 +1289,18 @@ struct chaine { static const struct chaine CHAINE_NULL = CHAINE_NULL__; .Ed .Pp +N'utiliser la macro que lorsqu'il est impossible d'utiliser la variable +constante, en l'occurence pour initialiser, dès sa définition, les +membres d'une autre variable structurée : +.Bd -literal -offset Ds +struct qux { + struct chaine foo; + int bar; +}; +#define QUX_DEFAULT__ {CHAINE_NULL__, 0} +static const struct qux QUX_DEFAULT = QUX_DEFAULT__; +.Ed +.Pp Éviter d'utiliser une déclaration typedef des structures afin d'autoriser leur déclaration anticipée. Et l'utilisation de pointeur vers une donnée structurée sans avoir en à