函数

GLibvasprintf

自以来:2.4

声明 [src]

gint
g_vasprintf (
  gchar** string,
  const gchar* format,
  va_list args
)

说明 [src]

vasprintf() 函数的 GNU 实现,支持位置参数,如规范的 Single Unix 中所指定。此函数类似于 g_vsprintf(),区别在于它为输出分配一个字符串,而不是将其输出放到你预先分配的缓冲区。

保证 string 中的返回值为非 NULL,除非 format 包含 %lc%ls 转换,在缺少多字节表达时可用,否则可能失败。

为了使用此函数,必须明确包含 glib/gprintf.h

自版本 2.4 起可用

此函数不能直接用于语言绑定。

参数

string

类型: gchar**

返回分配的新字符串的位置,如果(且仅当)此函数失败时为 NULL

此参数将由函数设置。
函数调用者拥有已返回数据的拥有权,并负责释放它。
该值是一个以 NUL 结尾的 UTF-8 字符串。
format

类型: const gchar*

标准的 printf() 格式字符串,请注意字符串精度的注意事项

此数据由函数调用者所有。
该值是一个以 NUL 结尾的 UTF-8 字符串。
args

类型: va_list

插入输出的参数列表。

返回值

类型: gint

打印的字节数,如果失败,则为-1。