asprintf, aswprintf, vasprintf, vaswprintf
来自 cppreference.cn
定义于头文件 <stdio.h> |
||
int asprintf( char **restrict strp, const char *restrict fmt, ... ); |
(1) | (动态内存 TR) |
int aswprintf( wchar_t **restrict strp, const wchar_t *restrict fmt, ... ); |
(2) | (动态内存 TR) |
int vasprintf( char **restrict strp, const char *restrict fmt, va_list arg ); |
(3) | (动态内存 TR) |
int vaswprintf( wchar_t **restrict strp, const wchar_t *restrict fmt, va_list arg ); |
(4) | (动态内存 TR) |
1) 类似于 sprintf,但它会分配足够大的存储空间来容纳输出,包括终止空字符,就像调用 malloc 一样,并通过第一个参数返回指向该存储空间的指针。不再需要时,应将此指针传递给 free 以释放分配的存储空间。
3) 同 (1),但可变参数列表被
arg
替换,arg
应该通过 va_start 宏(可能还有后续的 va_arg 调用)进行初始化。4) 同 (3),但它处理宽字符 wchar_t。
目录 |
[编辑] 参数
strp | - | 指向将包含格式化输出的 char* 或 wchar_t* 的指针 |
fmt | - | 格式字符串,与 printf/wprintf 及相关函数相同 |
arg | - | 任何额外参数,与 vsprintf 和 vswprintf 相同 |
[编辑] 返回值
写入的字符数,分别与 sprintf (1)、swprintf (2)、vsprintf (3) 或 vswprintf (4) 相同。如果内存分配失败或发生其他错误,这些函数将返回 -1,且 strp
的内容未定义。
[编辑] 注意
这些函数是 GNU 扩展,不在 C 或 POSIX 标准中。它们也可在 *BSD 下使用。FreeBSD 的实现会在错误时将 strp
设置为 NULL
。
vasprintf
和 vaswprintf
函数不调用 va_end 宏。
[编辑] 示例
可用 clang (C11) 进行测试
运行此代码
#include <stdio.h> #include <stdlib.h> #include <stdarg.h> void test(const char *fmt, ...) { char* dyn_buf; printf("Demo asprintf:\n"); const int written_1 = asprintf(&dyn_buf, "%s", fmt); printf("dyn_buf: \"%s\"; %i chars were written\n", dyn_buf, written_1); free(dyn_buf); printf("Demo vasprintf:\n"); va_list args; va_start(args, fmt); const int written_2 = vasprintf(&dyn_buf, fmt, args); va_end(args); printf("dyn_buf: \"%s\"; %i chars were written\n", dyn_buf, written_2); free(dyn_buf); } int main(void) { test("Testing... %d, %d, %d", 1, 2, 3); }
输出
Demo asprintf: dyn_buf: "Testing... %d, %d, %d"; 21 chars were written Demo vasprintf: dyn_buf: "Testing... 1, 2, 3"; 18 chars were written