方法

gioOutputStreamvprintf

自:2.40

声明 [源]

gboolean
g_output_stream_vprintf (
  GOutputStream* stream,
  gsize* bytes_written,
  GCancellable* cancellable,
  GError** error,
  const gchar* format,
  va_list args
)

说明 [源]

这是一个关于 g_output_stream_write_all() 的辅助函数,它使用 g_strdup_vprintf() 将 format 和 args 转换为一个字符串,然后将该字符串写入到 stream 中。

有关实际写入操作的行为,请参阅 g_output_stream_write_all() 的文档。

请注意,由于写入字符串的长度是可变的,因此无法使用此函数正确检查部分写入,如果需要精确控制部分写入失败,则需要围绕 g_output_stream_write() 或 g_output_stream_write_all() 创建自己的 printf() 类型的包装器。

自:2.40

此方法对语言绑定不可直接访问。

参数

bytes_written

类型: gsize*

存储写入到流中的字节数的位置。

该参数将由函数设置。
该参数可以是 NULL
cancellable

类型: GCancellable

可选的 GCancellable 对象,NULL 表示忽略。

该参数可以是 NULL
数据由方法调用者拥有。
error

类型: GError

存储发生错误的位置,或 NULL 表示忽略。

数据由方法调用者拥有。
format

类型: const gchar*

格式字符串,请参阅 printf() 文档。

数据由方法调用者拥有。
该值是空终止的 UTF-8 字符串。
args

类型: va_list

插入到格式字符串中的参数。

返回值

类型: gboolean

成功时为TRUE,出错时为FALSE。