Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / C

va_copy — copiar o estado de uma lista de argumentos

va_copy inicializa um estado va_list independente na posição atual da origem, permitindo ler separadamente os mesmos argumentos.

Versão: C23; repository compiler flag, production runtime not attested

Sintaxe

#include <stdarg.h>
void va_copy(va_list dest, va_list src);

va_copy(dest, src) de <stdarg.h> inicializa dest com o estado atual de um src inicializado corretamente; não devolve nada. A cópia não recomeça do início. As leituras através de va_arg fazem avançar cada lista de forma independente.

Utilize va_copy, e não uma atribuição nem memcpy. Cada va_start e va_copy requer um va_end correspondente na mesma função. Antes de reinicializar um dest ativo, chame va_end(dest).

No exemplo, 10 é ignorado antes da cópia, pelo que ambas as listas leem 20. Um argumento do tipo int é lido como int. A norma descreve va_copy como uma macro, mas permite uma implementação como identificador com ligação externa; não suprima a definição da macro.

Exemplos

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

static void show_next_twice(int count, ...)
{
    va_list src, dest;
    va_start(src, count);

    if (count >= 2) {
        (void)va_arg(src, int);
        va_copy(dest, src);

        int a = va_arg(src, int);
        int b = va_arg(dest, int);
        printf("%d %d\n", a, b);

        va_end(dest);
    }

    va_end(src);
}

int main(void)
{
    show_next_twice(3, 10, 20, 30);
    return 0;
}

Resultado

20 20

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes