C++

参考

<cstdlib> (stdlib.h)

函数
<cstdlib>

atol

long int atol ( const char * str );
将字符串转换为长整数
该函数解析C风格字符串str，将其内容解释为整数，并返回long int类型的值。

该函数首先尽可能多地跳过空白字符（如isspace中的定义），直到找到第一个非空白字符。然后，从该字符开始，读取可选的初始加号或减号，后跟尽可能多的十进制数字，并将它们解释为数值。

字符串中可能包含构成整数数字之后的其他字符，这些字符将被忽略，对该函数行为没有影响。

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

参数

str
包含整数表示的 C 字符串。

返回值

成功时，该函数将转换后的整数作为long int值返回。
如果无法执行有效的转换，则返回零值。
如果转换后的值超出long int可表示的范围，则会导致未定义行为。如果可能出现这种情况，请参阅strtol以获得更健壮的跨平台替代方法。

示例

1
2
3
4
5
6
7
8
9
10
11
12
13
14
 
/* 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风格字符串，或者转换后的值超出long int可表示的范围，则会导致未定义行为。

另见

atoi
将字符串转换为整型 (函数)
atof
将字符串转换为 double (函数)
strtol
将字符串转换为长整型 (函数)