strtol, wcstol, _strtol_l, _wcstol_l
将字符串转换为长整数值。
long strtol(
const char *nptr,
char **endptr,
int base
);
long wcstol(
const wchar_t *nptr,
wchar_t **endptr,
int base
);
long _strtol_l(
const char *nptr,
char **endptr,
int base,
_locale_t locale
);
long _wcstol_l(
const wchar_t *nptr,
wchar_t **endptr,
int base,
_locale_t locale
);
参数
nptr
转换的 null 终止的字符串。endptr
若要停止扫描字符的指针。base
使用的数基。locale
使用的区域设置。
返回值
strtol 返回该字符串表示的值, nptr,但,则表示可能导致溢出,,在返回 LONG_MAX 或 LONG_MIN情况下。 转换,则不能执行,strtol 返回 0。 wcstol 类似将值返回给 strtol。 对于两个函数,因此,如果溢出或下溢时发生, errno 设置为 ERANGE 。
请参见 _doserrno、 errno、 _sys_errlist 和 _sys_nerr 有关这些属性和其他的更多信息返回代码。
备注
strtol 函数 nptr 为 long。 读取字符串 nptr 的strtol 停止在作为数字的一部分,它无法识别的第一个字符。 这可能是终止 null 字符),也可能是第一个数字字符大于或等于 base。
wcstol 是 strtol的宽字符版本;其 nptr 参数是宽字符字符串。 这些功能否则具有相同的行为。
一般文本例程映射
TCHAR.H 实例 |
未定义的 _UNICODE _MBCS |
定义的 _MBCS |
定义的 _UNICODE |
---|---|---|---|
_tcstol |
strtol |
strtol |
wcstol |
_tcstol_l |
_strtol_l |
_strtol_l |
_wcstol_l |
当前区域设置的 LC_NUMERIC类别以确定基数字符的标识 nptr的*;* 有关更多信息,请参见 setlocale。 不 _l 后缀的功能使用当前区域设置; _strtol_l 和 _wcstol_l 与相应的功能是相同的不 _l 后缀,但它们使用的区域设置。 有关更多信息,请参见 区域设置。
如果 endptr 不是 NULL,对停止扫描的字符的指针在位置存储指向由 endptr。 如果转换不能执行 (未找到有效的数值或无效的基本指定了), nptr 的值在位置存储指向由 endptr。
strtol希望 nptr 指向以下格式的字符串:
[whitespace] [{+ |–}] [0 [{ x |X }]] [digits]
whitespace 可以包含空格和制表符,将忽略; digits 是一个或多个十进制数字。 不适合此窗体停止扫描的第一个字符。 如果 base 在 2 和 36 之间,则将它作为该数字的基础。 如果 base 为 0,字符串的初始字符指向由 nptr 用于确定基础。 如果第一个字符是 0,第二个字符不是 " x " 或 " X ",字符串被解释为一个八进制整数;否则,它将被解释为十进制数字。 如果第一个字符为 “0 ",第二个字符是 " x " 或 " X ",字符串被解释为十六进制整数。 如果第一个字符为 " 1 " 到 " 9 ",字符串被解释为十进制整数。 字母 " a " 到 “z (或 " A " 到 “Z) 赋值 10 到 35;比 base 进行值小于只允许的字母。
要求
实例 |
必需的头 |
---|---|
strtol |
stdlib.h |
wcstol |
stdlib.h 或 wchar.h |
_strtol_l |
stdlib.h |
有关其他的兼容性信息,请参见中介绍的 兼容性 。
示例
为 strtod参见示例。
.NET Framework 等效项
请参见
参考
strtod, _strtod_l, wcstod, _wcstod_l