asprintf, aswprintf, vasprintf, vaswprintf

 

C

编译器支持

语言

头文件

类型支持

程序实用工具

可变参数函数支持

错误处理

动态内存管理

字符串库

算法

数值

日期和时间实用工具

输入/输出支持

本地化支持

并发支持 (C11)

技术规范

符号索引

 

技术规范

嵌入式处理器扩展

动态内存扩展

浮点扩展第 1 部分：二进制浮点

浮点扩展第 4 部分：补充函数

 

动态内存扩展

fmemopen

open_memstreamopen_wmemstream

asprintfaswprintfvasprintfvaswprintf

getlinegetwlinegetdelimgetwdelim

strdup

strndup

 

定义于头文件 <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，它应由 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