函数
<cstdlib>

atoi

int atoi (const char * str);
将字符串转换为整数
解析 C 字符串 str,将其内容解释为一个整数,并以 int 类型的值返回。

该函数首先丢弃所有必要的空白字符(如同在 isspace 中),直到找到第一个非空白字符。然后,从这个字符开始,取一个可选的前置正号负号,后跟尽可能多的十进制数字,并将它们解释为一个数值。

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

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

参数

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

返回值

成功时,函数返回转换后的整数,类型为 int
如果转换后的值超出了 int 可表示的值的范围,将导致未定义行为。如果可能出现这种情况,请参见 strtol 以获取更健壮的跨平台替代方案。

示例

1
2
3
4
5
6
7
8
9
10
11
12
13
14
/* atoi example */
#include <stdio.h>      /* printf, fgets */
#include <stdlib.h>     /* atoi */

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

输出

Enter a number: 73
The value entered is 73. Its double is 146.


数据竞争

访问由 str 指向的数组。

异常 (C++)

无异常保证:此函数从不抛出异常。

如果 str 没有指向一个有效的 C 字符串,或者转换后的值超出了 int 可表示的值的范围,将导致未定义行为

另见