Функция atoi

Прототип функции atoi:

int atoi( const char * string );

Описание

Функция atoi преобразует строку string в целое значение типа int. Анализируя строку string, atoi интерпретирует её содержание, как целое число, которое возвращается как int.

Функция сначала отбрасывает символы пробелов до тех пор, пока не будет найден символ отличный от нуля. Затем, начиная с этого символа, функция принимает необязательный начальный знак плюс или минус. После чего, следует  последовательность цифр, которая интерпретируется в числовое значение.

Строка может содержать другие символы после считанного целого числа, эти символы игнорируются и никак не влияют на поведение этой функции.

Если первая последовательность не-пробельных символов в строке string не является целым числом, или, если string пустая  или содержит только пробельные символы, преобразование не выполняется.

Параметры:

• string
  Строка для преобразования в целое число.

Возвращаемое значение

В случае успеха, функция возвращает целое число преобразованное к типу int.
Если в строке не было найдено целое число, функция возвращает нулевое значение.
Существует не стандартная ситуация, когда преобразованное значение выйдет из диапазона принимаемых значений типа данных int. Поэтому, предусмотрена более надежная кросс-платформенная альтернатива — функция strtol.

Пример: исходный код программы

//пример использования функции atoi
#include <iostream>
#include <cstdlib>

int main()
{
  char input [256];
  std::cout << "Введите число: ";
  std::cin >> input;

  int value = atoi(input);
  std::cout << "Введенное число - " << value << ", удвоим его = " << (value * 2);
  return 0;
}

Пример работы программы