atoi

Функция atoi (ASCII to integer, из ASCII в целое число) в языке программирования Си используется для приведения (конвертации) строки в числовой вид.

int atoi(const char *str)

Аргумент str означает строку, представленную в виде массива символов, содержащего символы знакового целого (тип int) числа. Строка должна быть нуль-терминированной, то есть оканчиваться символом «\0». Когда atoi() получает строку без числовых последовательностей, то в этом случае возвращает ноль (0). Если строка содержит корректную последовательность цифр, представляющих число 0, то также возвращается 0, при этом по возвращаемому числу невозможно определить содержит ли строка корректное число или нет. Более новая функция strtol не имеет подобного недостатка.

Варианты функции atoi — atol, atof и atoll (впоследствии известная как atoq) используются для приведения строки к типам long, double или long long, соответственно:

long atol(const char *str)

double atof(const char *str)

long long atoll(const char *str) (C99)

Соответствие стандартам

Функции atoi, atof и atol являются частью стандартной библиотеки Си (ISO) C89, а функция atoll была добавлена в стандарте C99.

См. также

• atof
• itoa
• strtod
• strtol

Ссылки

• Описание atoi из C++ Reference  (англ.)
• atof, atoi, atol — преобразовать в плавающее — пример использования  (рус.)
• Функция atoi — описание и пример использования  (рус.)
• atoi в man’ах  (рус.)