commit 86131d6f7f364b35e0027d2d3b97511a707ad7a7
parent dc006978cd07c7d107cb72d4c4706822fcec4ada
Author: Vincent Forest <vincent.forest@meso-star.com>
Date: Thu, 16 Jul 2026 22:12:36 +0200
Relecture
Diffstat:
1 file changed, 22 insertions(+), 19 deletions(-)
diff --git a/doc/fr/star-c.7 b/doc/fr/star-c.7
@@ -1132,29 +1132,32 @@ de type structuré, afin d'éviter le surcoût de sa copie à chaque appel de
fonction ; son occupation mémoire étant a priori plus important
qu'une donnée simple.
.Pp
-Les arguments d'une fonction peuvent ne pas être utilisés à l'intérieur
-de la fonction.
-C'est notamment le cas si l'argument n'est utile que pour répondre à un
-profil spécifique, par exemple pour être utilisé en tant que valeur d'un
-pointeur de fonction donné.
-Ou si l'argument n'est utile que dans un contexte de compilation
-spécifique, par exemple pour le débogage.
-Lister alors ces variables non utilisée en en-tête de la fonction, après la
-définition des variables locales, en la préfixant de la directive
-.Ql (void)
-Et d'ainsi ignorer explicitement leur utilisation, tout en désactivant
-l'avertissement de compilation quant à la déclaration de variable non
-utilisée
-.Pq option Fl Wunused-variable No de Xr gcc 1 Ns
- :
+Les paramètres d'une fonction peuvent ne pas être utilisés à l'intérieur
+de celle-ci.
+C'est notamment le cas si les paramètres ne sont utiles que pour
+répondre à un profil de fonction spécifique ou dans un contexte de
+compilation particulier, par exemple pour le débogage.
+Lister ces paramètres en en-tête de la fonction, après
+la définition des variables locales, en les préfixant d'une conversion
+explicite vers un type vide :
.Bd -literal -offset Ds
static void
-foo(int x, int y)
+foo(int x, int y, int z)
{
- (void)x, (void)y; /* Variables inutilisées */
- printf("Foobar\en");
+ int i = 0;
+ (void)y, (void)z; /* Paramètres inutilisés */
+
+ i = bar(x);
+ if (i < 42) {
+ printf("Foobar\en");
+ }
}
.Ed
+.Pp
+Cette liste explicite quels paramètres sont ignorés, en plus de
+désactiver les avertissements de compilation quant à la définition de
+paramètres non utilisés
+.Pq option Fl Wunused-parameter No de Xr gcc 1 .
.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
.Sh LES VARIABLES
Limiter le nombre de variables par bloc entre 5 et 10.
@@ -1171,7 +1174,7 @@ liste des membres peut changer, sans que le code appelant n'est
forcément à s'en soucier dès lors qu'ils sont correctement initialisés.
Si elle existe, utiliser la constante proposée avec la structure pour
initialiser une variable de ce type.
-.Pq voir section Sx LES CONSTANTES .
+.Pq voir section Sx LES STRUCTURES .
En son absence n'initialiser que le premier membre de la variable ; le
language C assure alors que les autres membres seront initialisés à
zéro.
