函数

GLibprintf_string_upper_bound

声明 [源代码]

gsize
g_printf_string_upper_bound (
  const gchar* format,
  va_list args
)

描述 [源代码]

计算存储 sprintf() 函数输出所需的最大空间。

如果 format 或 args 无效，则返回 0。例如，当 format 包含 %lc 或 %ls 占位符，且 args 包含无法用多字节编码表示的宽字符时，这种情况就会发生。如果 format 为 %s，且 args 为空字符串，则也会合法地返回 0。如有必要，调用者负责区分这两种返回值。建议无论如何都不要使用 %lc 或 %ls 占位符，因为它们的行为取决于区域设置。

此函数不会直接提供给语言绑定。

参数

format

类型: const gchar*

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

数据归函数调用者所有。
该值为以 NUL 结尾的 UTF-8 字符串。
args

类型: va_list

要插入格式字符串的参数。

返回值

类型: gsize

存储格式化字符串所需的最大空间，或 0 表示发生错误。