atoi, , _atoi_l_wtoi_wtoi_l

Преобразуют строку в целое число.

Синтаксис

int atoi(
   const char *str
);
int _wtoi(
   const wchar_t *str
);
int _atoi_l(
   const char *str,
   _locale_t locale
);
int _wtoi_l(
   const wchar_t *str,
   _locale_t locale
);

Параметры

str
Строка для преобразования.

locale
Используемый языковой стандарт.

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

Каждая функция возвращает значение int, которое создается за счет интерпретации входных символов как числа. Возвращаемое значение равно 0 atoi и _wtoi, если входные данные не могут быть преобразованы в значение этого типа.

При переполнении функций большими отрицательными целыми значениями LONG_MIN возвращается. В подобных условиях atoi и _wtoi возвращают INT_MAX и INT_MIN. Во всех случаях, когда диапазон не соблюдается, errno принимает значение ERANGE. Если параметр передан NULL, вызывается обработчик недопустимых параметров, как описано в разделе проверки параметров. Если продолжение выполнения разрешено, эти функции устанавливают для errno значение EINVAL и возвращают 0.

Замечания

Эти функции преобразуют символьную строку в целое значение (atoi и _wtoi). Входная строка представляет собой последовательность символов, которые могут обрабатываться как числовое значение указанного типа. Функция перестает считывать входную строку на первом символе, который не может распознаваться как часть числа. Этот символ может быть нуль-символом ("\0" или L"\0"), которым завершается строка.

Аргумент str для atoi и _wtoi принимает следующую форму:

[] [whitespace] [sign] [digits]

A whitespace состоит из пробелов или символов табуляции, которые игнорируются; sign либо плюс (+) или минус (-); и digits являются одним или несколькими цифрами.

Версии этих функций с суффиксом _l идентичны, за исключением того, что они используют переданный параметр языкового стандарта вместо текущего языкового стандарта. Дополнительные сведения см. в разделе Locale.

По умолчанию глобальное состояние этой функции ограничивается приложением. Чтобы изменить это поведение, см . статью "Глобальное состояние" в CRT.

Сопоставления подпрограмм универсального текста

TCHAR.H Обычной	_UNICODE и _MBCS не определен	_MBCS Определенные	_UNICODE Определенные
_tstoi	atoi	atoi	_wtoi
_ttoi	atoi	atoi	_wtoi

Требования

Подпрограммы	Обязательный заголовок
atoi	<stdlib.h>
_atoi_l, , _wtoi_wtoi_l	<stdlib.h> или <wchar.h>

Пример

Эта программа показывает, как числа, хранящиеся в виде строки, можно преобразовать в числовые значения с помощью функции atoi.

// crt_atoi.c
// This program shows how numbers
// stored as strings can be converted to
// numeric values using the atoi functions.

#include <stdlib.h>
#include <stdio.h>
#include <errno.h>

int main( void )
{
    char    *str = NULL;
    int     value = 0;

    // An example of the atoi function.
    str = "  -2309 ";
    value = atoi( str );
    printf( "Function: atoi( \"%s\" ) = %d\n", str, value );

    // Another example of the atoi function.
    str = "31412764";
    value = atoi( str );
    printf( "Function: atoi( \"%s\" ) = %d\n", str, value );

    // Another example of the atoi function
    // with an overflow condition occurring.
    str = "3336402735171707160320";
    value = atoi( str );
    printf( "Function: atoi( \"%s\" ) = %d\n", str, value );
    if (errno == ERANGE)
    {
       printf("Overflow condition occurred.\n");
    }
}

Function: atoi( "  -2309 " ) = -2309
Function: atoi( "31412764" ) = 31412764
Function: atoi( "3336402735171707160320" ) = 2147483647
Overflow condition occurred.

См. также

Преобразование данных
Поддержка математических и плавающих точек
Локаль
_ecvt
_fcvt
_gcvt
setlocale, _wsetlocale
_atodbl, , _atodbl_l_atoldbl_l_atoldbl_atoflt,_atoflt_l