commit 0843b37d530f906704cbc9e50cf99eb81825bcd4
parent d228a94339eb9b694f159a5a2f0eec8e67dd5686
Author: Vincent Forest <vincent.forest@meso-star.com>
Date: Thu, 16 Jul 2026 18:03:30 +0200
Complète la section sur les fonctions
Diffstat:
1 file changed, 24 insertions(+), 0 deletions(-)
diff --git a/doc/fr/star-c.7 b/doc/fr/star-c.7
@@ -1131,6 +1131,30 @@ Utiliser un pointeur constant dès lors que le paramètre d'entrée est
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
+ :
+.Bd -literal -offset Ds
+static void
+foo(int x, int y)
+{
+ (void)x, (void)y; /* Variables inutilisées */
+ printf("Foobar\en");
+}
+.Ed
.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
.Sh LES VARIABLES
Limiter le nombre de variables par bloc entre 5 et 10.
