函数

GLibascii_strtoll

自:2.12

声明 [来源]

gint64
g_ascii_strtoll (
  const gchar* nptr,
  gchar** endptr,
  guint base
)

描述 [来源]

将字符串转换为gint64值。

此函数的行为类似于C语言环境中的标准strtoll()函数。它这样做而不改变当前的语言环境,因为那样会不安全地更改线程。

当读取配置文件或其他与语言环境无关的非用户输入时,通常使用此函数。处理来自用户的输入时,应正常使用与语言环境敏感的系统的strtoll()函数。

如果正确的值会导致溢出,则返回G_MAXINT64G_MININT64,并将ERANGE存储在errno中。如果基数超出有效范围,返回零,并将EINVAL存储在errno中。如果字符串转换失败,则返回零,并将endptr返回nptr(如果endptr非NULL)。

自:2.12

参数

nptr

类型: const gchar*

要转换为数值的字符串。

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

类型: gchar**

如果非NULL,则返回转换中使用的最后一个字符之后的字符。

此参数将由函数设置。
参数可以为NULL。
返回的数据由函数拥有。
该值是一个以NUL结尾的UTF-8字符串。
base

类型: guint

用于转换,2..36或0。

返回值

类型: gint64

转换后的值,或者在错误时返回零。