strtol ()-strtol()- 将字符串转换为长整型和长整型整数

在线编辑

格式 (strtol())

#include <stdlib.h>
long int strtol(const char *nptr, char **endptr, int base);

格式 (strtoll())

#include <stdlib.h>
long long int strtoll(char *string, char **endptr, int base);

语言级别

ANSI

线程安全

是

语言环境敏感

这些函数的行为可能受当前语言环境的 LC_CTYPE 类别影响。 有关更多信息，请参阅 了解 CCSID 和语言环境。

描述

strtol() 函数将字符串转换为长整数值。 参数 nptr 指向可解释为 long int 类型的数字值的字符序列。

strtoll() 函数将字符串转换为长整型整数值。 参数 nptr 指向可以解释为 long long int 类型的数字值的字符序列。

使用这些函数时， nptr 参数应指向具有以下格式的字符串:

读取语法图跳过可视语法图空格 +  – 00x0X数字

如果 base 参数是介于 2 与 36 之间的值，那么主体序列的期望格式是表示其基数由 base 参数指定的整数的字母和数字序列。 此序列可选择以正 (+) 或负 (-) 符号开头。 从 a 到 z 的字母 (大写或小写) 归为值 10 到 35; 只允许其归为值小于基本参数的字母。 如果基本参数的值为 16 ，那么字符 0x 或 0X (可选) 在字母和数字序列前，后跟正 (+) 或负 (-) 符号 (如果存在)。

如果基本参数的值为 0 ，那么字符串将确定基本参数。 在可选前导符号后，前导 0 指示八进制转换，前导 0x 或 0X 指示十六进制转换，所有其他前导字符都会导致十进制转换。

这些函数将字符串扫描到与 base 参数不一致的第一个字符。 此字符可能是字符串末尾的空字符 ('\0') 。 将忽略前导空格字符，并且可选的符号可以在数字之前。

如果 endptr 参数的值不是空指针，那么结束扫描的字符的指针将存储在 endptr指向的值中。 如果无法形成值，那么 endptr 指向的值将设置为 nptr 参数

返回值

如果 base 具有无效值 (小于 0 ， 1 或大于 36) ，那么 errno 将设置为 EINVAL 并返回 0。 endptr 参数指向的值设置为 nptr 参数的值。

如果该值超出可表示值的范围，那么 errno 将设置为 ERANGE。 如果值为正数，那么 strtol() 函数将返回 LONG_MAX ，而 strtoll() 函数将返回 LONGLONG_MAX。 如果值为负数，那么 strtol() 函数将返回 LONG_MIN ，而 strtoll() 函数将返回 LONGLONG_MIN。

如果未转换任何字符，那么 strtoll() 和 strtol() 函数会将 errno 设置为 EINVAL 并返回 0。 对于这两个函数， endptr 指向的值设置为 nptr 参数的值。 成功完成后，这两个函数都会返回转换后的值。

示例

此示例将字符串转换为 long 值。 它将显示已转换的值以及停止转换的子串。
#include <stdlib.h>
#include <stdio.h>
 
int main(void)
{
   char *string, *stopstring;
   long l;
   int bs;
 
   string = "10110134932";
   printf("string = %s\n", string);
   for (bs = 2; bs <= 8; bs *= 2)
   {
      l = strtol(string, &stopstring, bs);
      printf("   strtol = %ld (base %d)\n", l, bs);
      printf("   Stopped scan at %s\n\n", stopstring);
      }
}
 
/*****************  Output should be similar to:  *****************
 
string = 10110134932
   strtol = 45 (base 2)
   Stopped scan at 34932
 
   strtol = 4423 (base 4)
   Stopped scan at 4932

相关信息