NAZWA¶

stdarg, va_start, va_arg, va_end, va_copy - listy zmiennych argumentów

SKŁADNIA¶

#include <stdarg.h>

void va_start(va_list ap, last);
type va_arg(va_list ap, type);
void va_end(va_list ap);
void va_copy(va_list dest, va_list src);

OPIS¶

Funkcję można wołać z różną liczbą argumentów różnych typów. Plik nagłówkowy <stdarg.h> deklaruje typ va_list i definiuje trzy makra, iterujące przez listę argumentów, których liczba i typy nie są znane wywołanej funkcji.

Wywołana funkcja musi zadeklarować obiekt typu va_list, który jest używany przez makra va_start(), va_arg() i va_end().

va_list aq = ap;

va_list aq;
*aq = *ap;

va_list aq;
va_copy(aq, ap);
...
va_end(aq);

ATRYBUTY¶

Informacje o pojęciach używanych w tym rozdziale można znaleźć w podręczniku attributes(7).

ZGODNE Z¶

Makra va_start(), va_arg() oraz va_end() są zgodne z C89. C99 opisuje makro va_copy().

UWAGI¶

These macros are not compatible with the historic macros they replace. A backward-compatible version can be found in the include file <varargs.h>.

The historic setup is:

#include <varargs.h>
void
foo(va_alist)


    va_dcl
{


    va_list ap;


    va_start(ap);


    while (...) {


        ...


        x = va_arg(ap, type);


        ...


    }


    va_end(ap);
}

On some systems, va_end contains a closing '}' matching a '{' in va_start, so that both macros must occur in the same function, and in a way that allows this.

BŁĘDY¶

Unlike the varargs macros, the stdarg macros do not permit programmers to code a function with no fixed arguments. This problem generates work mainly when converting varargs code to stdarg code, but it also creates difficulties for variadic functions that wish to pass all of their arguments on to a function that takes a va_list argument, such as vfprintf(3).

PRZYKŁAD¶

Funkcja foo pobiera łańcuch znaków formatujących i wypisuje argumenty z nimi związane w oparciu o typ argumentu.

#include <stdio.h>
#include <stdarg.h>
void
foo(char *fmt, ...)
{


    va_list ap;


    int d;


    char c, *s;


    va_start(ap, fmt);


    while (*fmt)


        switch (*fmt++) {


        case 's':              /* string */


            s = va_arg(ap, char *);


            printf("string %s\n", s);


            break;


        case 'd':              /* int */


            d = va_arg(ap, int);


            printf("int %d\n", d);


            break;


        case 'c':              /* char */


            /* występuje tu potrzeba rzutowania, gdyż va_arg


               pobiera w pełni awansowane typy */


            c = (char) va_arg(ap, int);


            printf("char %c\n", c);


            break;


        }


    va_end(ap);
}

O STRONIE¶

Angielska wersja tej strony pochodzi z wydania 4.16 projektu Linux man-pages. Opis projektu, informacje dotyczące zgłaszania błędów oraz najnowszą wersję oryginału można znaleźć pod adresem https://www.kernel.org/doc/man-pages/.

TŁUMACZENIE¶

Autorami polskiego tłumaczenia niniejszej strony podręcznika są: Przemek Borys <pborys@dione.ids.pl>, Andrzej Krzysztofowicz <ankry@green.mf.pg.gda.pl>, Robert Luberda <robert@debian.org> i Michał Kułach <michal.kulach@gmail.com>

Niniejsze tłumaczenie jest wolną dokumentacją. Bliższe informacje o warunkach licencji można uzyskać zapoznając się z GNU General Public License w wersji 3 lub nowszej. Nie przyjmuje się ŻADNEJ ODPOWIEDZIALNOŚCI.

Błędy w tłumaczeniu strony podręcznika prosimy zgłaszać na adres listy dyskusyjnej manpages-pl-list@lists.sourceforge.net.