STRTOL(3C)

НАЗВАНИЕ
strtol, atol, atoi - преобразование цепочки символов в целое число

СИНТАКСИС

	long strtol (str, ptr, base)

	char *str, **ptr;

	int base;



	long atol (str)

	char *str;



	int atoi (str)

	char *str;

ОПИСАНИЕ
Результатом функции strtol является целое число типа long, заданное цепочкой символов, на которую указывает аргумент str. Цепочка просматривается до первого символа, несовместимого с выбранной системой счисления. Начальные пробельные символы [см. макрос isspace в ctype(3C)] игнорируются.

Если аргумент ptr не равен (char **) NULL, то в слове, на которое он ссылается, возвращается указатель на символ, вызвавший завершение просмотра. Если число сформировать не удается, то *ptr устанавливается равным str и в качестве результата возвращается ноль.

Если аргумент base положителен (и не превосходит 36), то он рассматривается как основание системы счисления. После необязательного знака могут следовать незначащие нули, которые игнорируются, а если основание равно 16, то игнорируются комбинации символов 0x и 0X.

Если аргумент base равен нулю, то основание определяется по составу символов цепочки: если после необязательного знака находится символ 0, то число считается восьмеричным, если 0x или 0X - то шестнадцатеричным, если любая другая цифра - десятичным.

Atol (str) эквивалентно strtol (str, (char **) NULL, 10).

Atoi (str) эквивалентно (int) strtol (str, (char **) NULL, 10).

СМ. ТАКЖЕ
ctype(3C), scanf(3S), strtod(3C).

СЮРПРИЗЫ
Переполнение игнорируется.