命名空间
变体
操作

asprintf, aswprintf, vasprintf, vaswprintf

来自 cppreference.cn
< c‎ | 实验性‎ | 动态
定义于头文件 <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 以释放分配的存储空间。
2)(1),但它处理宽字符 wchar_t(类似于 swprintf)。
3)(1),但可变参数列表被 arg 替换,arg 应该通过 va_start 宏(可能还有后续的 va_arg 调用)进行初始化。
4)(3),但它处理宽字符 wchar_t

目录

[编辑] 参数

strp - 指向将包含格式化输出的 char*wchar_t* 的指针
fmt - 格式字符串,与 printf/wprintf 及相关函数相同
arg - 任何额外参数,与 vsprintfvswprintf 相同

[编辑] 返回值

写入的字符数,分别与 sprintf (1)swprintf (2)vsprintf (3)vswprintf (4) 相同。如果内存分配失败或发生其他错误,这些函数将返回 -1,且 strp 的内容未定义。

[编辑] 注意

这些函数是 GNU 扩展,不在 C 或 POSIX 标准中。它们也可在 *BSD 下使用。FreeBSD 的实现会在错误时将 strp 设置为 NULL

vasprintfvaswprintf 函数不调用 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