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).
СМ. ТАКЖЕ
, , .
СЮРПРИЗЫ
Переполнение игнорируется.
