Keil头文件_stdarg.h详解.pdfVIP

stdarg.h stdarg.h stdarg.h是 C语言中 C 标准函式库的标头档，stdarg是由 standard(标 准) arguments(参数)简化而来，主要目的为让函式能够接收不定量参数。 [1] C++的 cstdarg 标头档中也提供这样的机能；虽然与 C 的标头档是相容 的，但是也有冲突存在。 不定参数函式(Variadic functions)是 stdarg.h 内容典型的应用，虽 然也可以使用在其他由不定参数函式呼叫的函式(例如，vprintf)。 宣告不定参数函式 不定参数函式的参数数量是可变动 的，它使用省略号来忽略之后的参 数。例如 printf 函式一般。代表性的宣告为: int check(int a, double b, ...); 不定参数函式最少要有一个命名的参数，所以 char *wrong(...); 在 C 是不被允许的(在 C++中，这样的宣告是合理的)。在 C，省略符号 之前必须要有逗号；在 C++，则没有这种强制要求。 定义不定参数函式 使用相同的语法来定义: long func(char, double, int, ...); long func(char a, double b, int c, ...) { /* ... */ } 在旧形式可能会出现较省略的函式定义: long func(); long func(a, b, c, ...) char a; double b; { /* ... */ } stdarg.h 型态名称 描述 相容 va_list 用来指向参数 C89 stdarg.h 巨集名称 描述 相容 va_start 使 va_list 指向起始的参数 C89 va_arg 检索参数 C89 va_end 释放 va_list C89 va_copy 拷贝 va_list 的内容 C99 存取参数 存取未命名的参数，首先必须在不定参数函式中宣告 va_list 型态的 变数。呼叫 va_start 并传入两个参数：第一个参数为 va_list 型态的变数， 第二个为函式最后一个参数的名称，接着每一呼叫 va_arg 就会回传下一个 参数，va_arg 的第一个参数为 va_list，第二个参数为回传的型态。最后 va_end 必须在函式回传前被 va_list 呼叫(当作参数)。(没有要求要读取完 所有参数) C99 提供额外的巨集，va_copy，它能够复制 va_list。而 va_copy(va2, va1)意思为拷贝 va1 到 va2。 没有机制定义该怎么判别传递到函式的参数量或者型态。函式通常需 要知道或确定它们变化的方法。共通的惯例包含: 使用 printf 或 scanf 类的格式化字串来嵌入明确指定的型态。 在不定参数最后的标兵值(sentinel value)。 总数变数来指明不定参数的数量。 型别安全性 有些 C 工具将 C 扩充允许编译器检查适当格式化字串及标兵 (sentinels)的使用。如果没有这个扩充，编译器通常无从检查传入函式的 未命名参数是否为所预期的型态。因此，必须对点做出谨慎的正确性确认， 型态没有吻合为未定义行为(Undefined behavior)。举个例，如果传入 NULL 指标，首先就是不能写入对应到适当指标型态但纯粹 NULL 的指标。再者考 虑预设参数应用到未命名参数。float 将会自动的被转换成 double?同样的 比 int(整数)更小容量的参数型态将会被转换成 int 或者 unsigned int?函 式所接收到的未命名参数必须预期到会被转换型态。 例子 #include stdio.h #include stdarg.h void printargs(int arg1, ...) /* 输出所有 int 型态的参数，直到 -1 结束 */ { va_list ap; int