.\" -*- coding: UTF-8 -*- .\" Copyright (c) 1990, 1991 The Regents of the University of California. .\" All rights reserved. .\" .\" This code is derived from software contributed to Berkeley by .\" the American National Standards Committee X3, on Information .\" Processing Systems. .\" .\" %%%LICENSE_START(BSD_4_CLAUSE_UCB) .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: .\" 1. Redistributions of source code must retain the above copyright .\" notice, this list of conditions and the following disclaimer. .\" 2. Redistributions in binary form must reproduce the above copyright .\" notice, this list of conditions and the following disclaimer in the .\" documentation and/or other materials provided with the distribution. .\" 3. All advertising materials mentioning features or use of this software .\" must display the following acknowledgement: .\" This product includes software developed by the University of .\" California, Berkeley and its contributors. .\" 4. Neither the name of the University nor the names of its contributors .\" may be used to endorse or promote products derived from this software .\" without specific prior written permission. .\" .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" %%%LICENSE_END .\" .\" @(#)stdarg.3 6.8 (Berkeley) 6/29/91 .\" .\" Converted for Linux, Mon Nov 29 15:11:11 1993, faith@cs.unc.edu .\" Additions, 2001-10-14, aeb .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH STDARG 3 "1 novembre 2020" "" "Manuel du programmeur Linux" .SH NOM stdarg, va_start, va_arg, va_end, va_copy \- Liste variable d'arguments .SH SYNOPSIS \fB#include \fP .PP \fBvoid va_start(va_list \fP\fIap\fP\fB, \fP\fIdernier\fP\fB);\fP .br \fItype\fP\fB va_arg(va_list \fP\fIap\fP\fB, \fP\fItype\fP\fB);\fP .br \fBvoid va_end(va_list \fP\fIap\fP\fB);\fP .br \fBvoid va_copy(va_list \fP\fIdest\fP\fB, va_list \fP\fIsrc\fP\fB);\fP .SH DESCRIPTION Une fonction peut être appelée avec un nombre variable d'arguments, eux\-mêmes de types variables. Une telle fonction est dite «\ variadique\ ». Le fichier d'en\-tête \fI\fP déclare un type \fIva_list\fP et définit trois macros permettant de parcourir la liste d'arguments dont le nombre et les types ne sont pas connus par la fonction appelée. .PP La fonction appelée doit déclarer un objet de type \fIva_list\fP utilisé par les macros \fBva_start\fP(), \fBva_arg\fP() et \fBva_end\fP(). .SS va_start() La macro \fBva_start\fP() initialise \fIap\fP pour les utilisations ultérieures de \fBva_arg\fP() et \fBva_end\fP(), et doit donc être appelée en premier. .PP Le paramètre \fIdernier\fP est le nom du dernier paramètre avant la liste variable de paramètres, c'est\-à\-dire le dernier paramètre dont la fonction connaisse le type. .PP Comme l'adresse de ce paramètre est utilisée dans la macro \fBva_start\fP(), il ne doit pas être déclaré comme une variable en registre, ni comme un type fonction ou tableau. .SS va_arg() La macro \fBva_arg\fP() se développe en une expression qui a le type et la valeur de l'argument suivant de l'appel. Le paramètre \fIap\fP est la \fIva_list\fP \fIap\fP initialisée par \fBva_start\fP(). Chaque appel de \fBva_arg\fP() modifie \fIap\fP pour que l'appel suivant renvoie le paramètre suivant. Le paramètre \fItype\fP est le nom du type, indiqué de telle manière qu'un pointeur sur un objet de ce type puisse être déclaré simplement en ajoutant un astérisque à \fItype\fP. .PP La première utilisation de la macro \fBva_arg\fP() après celle de \fBva_start\fP() renvoie l'argument suivant \fIdernier\fP. Les invocations successives renvoient les valeurs des arguments restants. .PP S'il n'y a pas d'argument suivant, ou si \fItype\fP n'est pas compatible avec le type du prochain argument effectif, des erreurs imprévisibles se produiront. .PP Si \fIap\fP est passé à une fonction qui utilise \fBva_arg(\fP\fIap\fP\fB,\fP\fItype\fP\fB)\fP alors la valeur de \fIap\fP est indéfinie après le retour de cette fonction. .SS va_end() À chaque invocation de \fBva_start\fP() doit correspondre une invocation de \fBva_end\fP() dans la même fonction. Après l'appel \fBva_end(\fP\fIap\fP\fB)\fP la variable \fIap\fP est indéfinie. Plusieurs traversées de la liste sont possibles, à condition que chacune soit encadrée par \fBva_start\fP() et \fBva_end\fP(). \fBva_end\fP() peut être une macro ou une fonction. .SS va_copy() La macro \fBva_copy\fP() copie la liste d'arguments variables (précédemment initialisés) \fIsrc\fP vers \fIdest\fP. Le comportement serait similaire si \fBva_start\fP() était appliqué à \fIdest\fP avec le même argument \fIdernier\fP, suivi du même nombre d'invocations de \fBva_arg\fP() qui seraient utilisées pour atteindre l'état actuel de \fIsrc\fP. .PP .\" Proposal from clive@demon.net, 1997-02-28 Une implémentation évidente est de représenter \fIva_list\fP par un pointeur dans la pile de la fonction variadique. Dans une telle situation (de loin la plus courante), rien ne semble s'opposer à une affectation .PP .in +4n .EX va_list aq = ap; .EE .in .PP Malheureusement, il y a aussi des systèmes qui créent une table de pointeurs (de longueur\ 1), et on devrait écrire .PP .in +4n .EX va_list aq; *aq = *ap; .EE .in .PP De plus, sur les systèmes où les paramètres sont passés dans des registres, il peut être nécessaire pour \fBva_start\fP() d'allouer de la mémoire, d'y enregistrer les paramètres ainsi que l'indication du paramètre suivant, afin que \fBva_arg\fP() puisse balayer la liste. Ainsi \fBva_end\fP() pourra libérer la mémoire allouée. Pour gérer ces situations, C99 ajoute une macro \fBva_copy\fP(), afin que les affectations ci\-dessus soient remplacées par .PP .in +4n .EX va_list aq; va_copy(aq, ap); \&... va_end(aq); .EE .in .PP À chaque invocation de \fBva_copy\fP() doit correspondre une invocation de \fBva_end\fP() dans la même fonction. Certains systèmes qui ne disposent pas de \fBva_copy\fP() ont une macro \fB__va_copy\fP() à la place, puisque c'était le nom proposé auparavant. .SH ATTRIBUTS Pour une explication des termes utilisés dans cette section, consulter \fBattributes\fP(7). .TS allbox; lbw21 lb lb l l l. Interface Attribut Valeur T{ \fBva_start\fP(), \fBva_end\fP(), \fBva_copy\fP() T} Sécurité des threads MT\-Safe T{ \fBva_arg\fP() T} Sécurité des threads MT\-Safe race:ap .TE .SH CONFORMITÉ Les macros \fBva_start\fP(), \fBva_arg\fP() et \fBva_end\fP() sont conformes à C89. C99 définit la macro \fBva_copy\fP(). .SH BOGUES Contrairement aux macros \fBvarargs\fP() historiques, les macros \fBstdarg\fP() ne permettent pas aux programmeurs de coder une fonction sans aucun argument fixe. Ce problème se pose principalement en convertissant directement du code utilisant \fBvarargs\fP() en code utilisant \fBstdarg\fP(), mais il se pose également pour les fonctions qui désirent passer tous leurs arguments à une fonction utilisant un argument \fIva_list\fP telle que \fBvfprintf\fP(3). .SH EXEMPLES La fonction \fIfoo\fP() prend une chaîne de caractères de mise en forme, et affiche les arguments associés avec chaque format correspondant au type indiqué. .PP .EX #include #include void foo(char *fmt, ...) /* \(aq...\(aq est la syntaxe C des fonctions variadiques */ { va_list ap; int d; char c; char *s; va_start(ap, fmt); while (*fmt) switch (*fmt++) { case \(aqs\(aq: /* chaîne */ s = va_arg(ap, char *); printf("chaîne %s\en", s); break; case \(aqd\(aq: /* entier */ d = va_arg(ap, int); printf("entier %d\en", d); break; case \(aqc\(aq: /* caractère */ /* il faut une conversion de type ici puisque va_arg ne prend que des types entièrement promus */ c = (char) va_arg(ap, int); printf("caractère %c\en", c); break; } va_end(ap); } .EE .SH "VOIR AUSSI" \fBvprintf\fP(3), \fBvscanf\fP(3), \fBvsyslog\fP(3) .SH COLOPHON Cette page fait partie de la publication\ 5.10 du projet \fIman\-pages\fP Linux. Une description du projet et des instructions pour signaler des anomalies et la dernière version de cette page peuvent être trouvées à l'adresse \%https://www.kernel.org/doc/man\-pages/. .SH TRADUCTION La traduction française de cette page de manuel a été créée par Christophe Blaess , Stéphan Rafin , Thierry Vignaud , François Micaux, Alain Portal , Jean-Philippe Guérard , Jean-Luc Coulon (f5ibh) , Julien Cristau , Thomas Huriaux , Nicolas François , Florentin Duneau , Simon Paillard , Denis Barbier , David Prévot , Cédric Boutillier , Frédéric Hantrais et Grégoire Scano . Cette traduction est une documentation libre ; veuillez vous reporter à la .UR https://www.gnu.org/licenses/gpl-3.0.html GNU General Public License version 3 .UE concernant les conditions de copie et de distribution. Il n'y a aucune RESPONSABILITÉ LÉGALE. Si vous découvrez un bogue dans la traduction de cette page de manuel, veuillez envoyer un message à .MT debian-l10n-french@lists.debian.org .ME .