Unix Man (Справочное руководство)

         

STRTOL(3C)


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 в ] игнорируются.

Если аргумент 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).

СМ. ТАКЖЕ


, , .

СЮРПРИЗЫ


Переполнение игнорируется.



Содержание раздела