| Contents |

17 <stdarg.h> Tham Số Biến Đổi

Macro Mô tả
va_arg() Lấy tham số biến đổi kế tiếp
va_copy() Copy một va_list và công việc đã làm tới thời điểm đó
va_end() Báo hiệu ta đã xử lý xong tham số biến đổi
va_start() Khởi tạo một va_list để bắt đầu xử lý tham số biến đổi

Header file này là cái cho phép bạn viết hàm nhận số lượng tham số biến đổi.

Ngoài các macro, bạn còn có một kiểu mới giúp C theo dõi vị trí đang xử lý đến đâu trong quá trình xử lý tham số biến đổi: va_list. Kiểu này là opaque, và bạn sẽ truyền nó quanh các macro khác nhau để giúp lấy tham số.

Chú ý mỗi hàm variadic cần ít nhất một tham số non-variable. Bạn cần cái này để khởi động xử lý với va_start().

17.1 va_arg()

Lấy tham số biến đổi kế tiếp

Synopsis

#include <stdarg.h>

type va_arg(va_list ap, type);

Mô tả

Nếu bạn có variable argument list đã được khởi tạo bằng va_start(), truyền nó vào đây cùng với kiểu của tham số bạn đang muốn lấy, ví dụ:

int   x = va_arg(args, int);
float y = va_arg(args, float);

Giá trị trả về

Eval thành giá trị và kiểu của tham số biến đổi kế tiếp.

Ví dụ

Đây là demo cộng số lượng integer tuỳ ý lại với nhau. Tham số đầu tiên là số lượng integer cần cộng. Ta sẽ dùng cái đó để biết phải gọi va_arg() bao nhiêu lần.

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

int add(int count, ...)
{
    int total = 0;
    va_list va;

    va_start(va, count);   // Bắt đầu với tham số sau "count"

    for (int i = 0; i < count; i++) {
        int n = va_arg(va, int);   // Lấy int kế tiếp

        total += n;
    }

    va_end(va);  // Xong hết

    return total;
}

int main(void)
{
    printf("%d\n", add(4, 6, 2, -4, 17));  // 6 + 2 - 4 + 17 = 21
    printf("%d\n", add(2, 22, 44));        // 22 + 44 = 66
}

Xem thêm

va_start(), va_end()

17.2 va_copy()

Copy một va_list và công việc đã làm tới thời điểm đó

Synopsis

#include <stdarg.h>

void va_copy(va_list dest, va_list src);

Mô tả

Mục đích chính của hàm này là lưu trạng thái giữa chừng trong quá trình xử lý tham số biến đổi để bạn có thể scan tới rồi rewind lại chỗ đã lưu.

Bạn truyền vào src va_list và nó copy sang dest.

Nếu đã gọi hàm này một lần cho một dest cụ thể, bạn không được gọi lại (hay gọi va_start()) với cùng dest đó trừ khi bạn gọi va_end() cho cái dest đó trước.

va_copy(dest, src);
va_copy(dest, src2);  // SAI!

va_copy(dest, src);
va_start(dest, var);  // SAI!

va_copy(dest, src);
va_end(dest);
va_copy(dest, src2);  // OK!

va_copy(dest, src);
va_end(dest);
va_start(dest, var);  // OK!

Giá trị trả về

Không trả về gì.

Ví dụ

Đây là ví dụ cộng tất cả tham số biến đổi lại, rồi quay lại cộng thêm tất cả các số từ thứ ba trở đi nữa, ví dụ nếu tham số là:

10 20 30 40

Đầu tiên ta cộng tất cả được 100, rồi cộng thêm mọi thứ từ số thứ ba, tức cộng 30+40, tổng ra 170.

Ta sẽ làm vậy bằng cách lưu vị trí trong quá trình xử lý tham số biến đổi với va_copy, rồi dùng nó sau để xử lý lại phần tham số đuôi.

(Và đúng rồi, tôi biết có cách toán học làm chuyện này mà không cần rewind, nhưng tôi đang khó lòng nghĩ ra ví dụ hay!)

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

// Cộng tất cả các số lại, rồi cộng lại lần nữa tất cả các số
// từ sau số thứ hai.
int contrived_adder(int count, ...)
{
    if (count < 3) return 0; // OK, tôi đang lười. Bắt được rồi đó.

    int total = 0;

    va_list args, mid_args;

    va_start(args, count);

    for (int i = 0; i < count; i++) {

        // Nếu ta đang ở số thứ hai, lưu chỗ vào
        // mid_args:

        if (i == 2)
            va_copy(mid_args, args);

        total += va_arg(args, int);
    }

    va_end(args); // Xong cái này

    // Nhưng giờ bắt đầu với mid_args và cộng hết những cái đó:
    for (int i = 0; i < count - 2; i++)
        total += va_arg(mid_args, int);

    va_end(mid_args); // Xong cái này luôn

    return total;
}

int main(void)
{
    // 10+20+30 + 30 == 90
    printf("%d\n", contrived_adder(3, 10, 20, 30));

    // 10+20+30+40+50 + 30+40+50 == 270
    printf("%d\n", contrived_adder(5, 10, 20, 30, 40, 50));
}

Xem thêm

va_start(), va_arg(), va_end()

17.3 va_end()

Báo hiệu ta đã xử lý xong tham số biến đổi

Synopsis

#include <stdarg.h>

void va_end(va_list ap);

Mô tả

Sau khi bạn đã va_start() hoặc va_copy một va_list mới, bạn phải gọi va_end() với nó trước khi nó ra khỏi scope.

Bạn cũng phải làm vậy nếu định gọi va_start() hoặc va_copy() lại trên biến mà bạn đã làm vậy rồi.

Đó là luật nếu bạn muốn tránh undefined behavior.

Nhưng cứ nghĩ nó như cleanup thôi. Bạn gọi va_start(), nên bạn sẽ gọi va_end() khi xong.

Giá trị trả về

Không trả về gì.

Ví dụ

Đây là demo cộng số lượng integer tuỳ ý lại với nhau. Tham số đầu tiên là số lượng integer cần cộng. Ta sẽ dùng cái đó để biết phải gọi va_arg() bao nhiêu lần.

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

int add(int count, ...)
{
    int total = 0;
    va_list va;

    va_start(va, count);   // Bắt đầu với tham số sau "count"

    for (int i = 0; i < count; i++) {
        int n = va_arg(va, int);   // Lấy int kế tiếp

        total += n;
    }

    va_end(va);  // Xong hết

    return total;
}

int main(void)
{
    printf("%d\n", add(4, 6, 2, -4, 17));  // 6 + 2 - 4 + 17 = 21
    printf("%d\n", add(2, 22, 44));        // 22 + 44 = 66
}

Xem thêm

va_start(), va_copy()

17.4 va_start()

Khởi tạo một va_list để bắt đầu xử lý tham số biến đổi

Synopsis

#include <stdarg.h>

void va_start(va_list ap, parmN);

Mô tả

Bạn đã khai báo một biến kiểu va_list để theo dõi quá trình xử lý tham số biến đổi… giờ làm sao khởi tạo nó để có thể bắt đầu gọi va_arg() lấy các tham số đó?

va_start() ra tay cứu nguy!

Việc bạn làm là truyền va_list của bạn vào, ở đây thể hiện qua tham số ap. Chỉ truyền list, không truyền pointer tới nó.

Rồi cho tham số thứ hai của va_start(), bạn đưa tên tham số mà bạn muốn bắt đầu xử lý tham số sau nó. Cái này phải là tham số ngay trước ... trong danh sách tham số.

Nếu bạn đã gọi va_start() trên một va_list cụ thể và muốn gọi va_start() lại trên nó, bạn phải gọi va_end() trước!

Giá trị trả về

Không trả về gì!

Ví dụ

Đây là demo cộng số lượng integer tuỳ ý lại với nhau. Tham số đầu tiên là số lượng integer cần cộng. Ta sẽ dùng cái đó để biết phải gọi va_arg() bao nhiêu lần.

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

int add(int count, ...)
{
    int total = 0;
    va_list va;

    va_start(va, count);   // Bắt đầu với tham số sau "count"

    for (int i = 0; i < count; i++) {
        int n = va_arg(va, int);   // Lấy int kế tiếp

        total += n;
    }

    va_end(va);  // Xong hết

    return total;
}

int main(void)
{
    printf("%d\n", add(4, 6, 2, -4, 17));  // 6 + 2 - 4 + 17 = 21
    printf("%d\n", add(2, 22, 44));        // 22 + 44 = 66
}

Xem thêm

va_arg(), va_end()

| Contents |