atol-c和c++标准函数

C&C++标准库

atol

函数 <cstdlib>

long int atol ( const char * str );

将字符串转换为long integer

解析C-string str，将其内容解释为整数值，并返回为long int类型的值。

函数丢弃所有开头的空格字符(如isspace)，直到找到第一个非空格字符。
然后，从这个字符开始，接受一个可选的加号或减号，后面跟着尽可能多的十进制数字，并将它们解释为一个数字值。

字符串可以在构成整数的字符之后包含额外的字符，这些字符将被忽略，并且对函数的行为没有影响。

如果str中的第一个非空白字符序列不是有效的整数值，或者由于str为空或仅包含空白字符而不存在这样的序列，则不执行转换并返回0。

☲ 参数

str
以整数表示开头的c字符串。

☉ 返回值

如果成功，函数将转换后的整数值作为long int值返回。

如果不能执行有效的转换，则返回零值。

如果转换后的值超出了long int类型可表示值的范围，则会导致未定义的行为。如果有可能，请参阅atol，以获得更健壮的跨平台替代方案。

☣ 示例

/* atol example */
#include <stdio.h>      /* printf, fgets */
#include <stdlib.h>     /* atol */

int main ()
{
  long int li;
  char buffer[256];
  printf ("Enter a long number: ");
  fgets (buffer, 256, stdin);
  li = atol(buffer);
  printf ("The value entered is %ld. Its double is %ld.\n",li,li*2);
  return 0;
}

输出:
Enter a number: 567283
The value entered is 567283. Its double is 1134566.

↭ 数据竞争

访问str所指向的数组。

❆ 异常(c++)

无抛出保证:此函数从不抛出异常。
如果str没有指向有效的C-string，或者转换后的值超出了long int可表示值的范围，则会导致未定义的行为。

🍄 另请参阅

strtol	将字符串转换为long integer(function )
atof	将string转换为double(function)
atoi	将string转换为integer(function)