Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C

va_end — zakończenie korzystania z listy argumentów

va_end z <stdarg.h> kończy korzystanie z va_list. Każde va_start lub va_copy wymaga odpowiadającego va_end w tej samej funkcji.

Wersja: C23; repository compiler flag, production runtime not attested

Składnia

#include <stdarg.h>
void va_end(va_list ap);

va_end(ap) z <stdarg.h> kończy korzystanie z va_list i nie zwraca wartości. Standard opisuje je jako makro, lecz dopuszcza również implementację jako identyfikator z łącznością zewnętrzną.

Każde va_start i va_copy wymaga odpowiadającego va_end w tej samej funkcji przed powrotem, także przy wcześniejszym wyjściu. Pominięcie tego wywołania lub wywołanie bez odpowiadającej inicjalizacji powoduje niezdefiniowane zachowanie.

Po va_end nie używaj ap ponownie bez inicjalizacji przez va_start lub va_copy. Nie trzeba wcześniej odczytać wszystkich argumentów.

Przykłady

#include <stdarg.h>
#include <stdio.h>

static int sum(int count, ...)
{
    va_list ap;
    va_start(ap, count);
    int total = 0;
    for (int i = 0; i < count; ++i) {
        total += va_arg(ap, int);
    }
    va_end(ap);
    return total;
}

int main(void)
{
    printf("%d\n", sum(3, 10, 20, 30));
    return 0;
}

Wynik

60

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła