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:
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 à