strtoul(3)

ИМЯ
strtoul, strtoull, strtouq - преобразование строки в целое с типом unsigned long integer

LIBRARY
Standard C library (libc, -lc)

СИНТАКСИС
#include <stdlib.h>

unsigned long strtoul(const char *restrict nptr,
                      char **restrict endptr, int base);
unsigned long long strtoull(const char *restrict nptr,
                      char **restrict endptr, int base);

    Требования макроса тестирования свойств для glibc (см. feature_test_macros(7)):

strtoull():
    _ISOC99_SOURCE
        || /* Glibc <= 2.19: */ _SVID_SOURCE || _BSD_SOURCE

ОПИСАНИЕ
The strtoul() function converts the initial part of the string in nptr to an unsigned long value according to the given base, which must be between 2 and 36 inclusive, or be the special value 0.

Строка может начинаться с произвольного количества пробельных символов (определяемых при помощи isspace(3)), затем может быть указан знак «+» или «-». Если base равно 0 или 16, то строка может начинаться с приставки «0x», что означает использование шестнадцатеричной системы исчисления; иначе, если base равно нулю, то используется десятичная система счисления (кроме, когда последующий символ также равен «0»: в этом случае используется восьмеричная система исчисления).

The remainder of the string is converted to an unsigned long value in the obvious manner, stopping at the first character which is not a valid digit in the given base. (In bases above 10, the letter 'A' in either uppercase or lowercase represents 10, 'B' represents 11, and so forth, with 'Z' representing 35.)

Если значение endptr не NULL, то strtoul() записывает адрес первого некорректного символа в *endptr. Если в строке вообще нет цифр, то strtoul() сохраняет изначальное значение nptr в *endptr (и возвращает 0). В частности, если *nptr не равно '\0', но **endptr равно '\0' при возврате, то вся строка состоит из корректных символов.

The strtoull() function works just like the strtoul() function but returns an unsigned long long value.

ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ
Функция strtoul() возвращает результат преобразования, либо, если был указан знак минуса, возвращается отрицательный результат преобразования, представленный в виде положительного числа, если изначальное (неотрицательное) значение не вызывает переполнения; в этом случае strtoul() возвращает ULONG_MAX, а переменной errno присваивается значение ERANGE. То же самое относится к strtoull(), только вместо ULONG_MAX возвращается ULLONG_MAX.

ОШИБКИ

EINVAL
    (нет в C99) Аргумент base содержит неподдерживаемое значение.

ERANGE
    Полученное значение вне диапазона.

Реализация может также устанавливать errno в EINVAL в случае, когда преобразование не было выполнено (не было встречено цифр и возвращён 0).

АТРИБУТЫ
Описание терминов данного раздела смотрите в attributes(7).
Интерфейс | Атрибут | Значение
strtoul(), strtoull(), strtouq() | Безвредность в нитях | MT-Safe locale

СТАНДАРТЫ
strtoul(): POSIX.1-2001, POSIX.1-2008, C89, C99 SVr4.

strtoull(): POSIX.1-2001, POSIX.1-2008, C99.

ЗАМЕЧАНИЯ
Так как strtoul() может обоснованно вернуть 0 или ULONG_MAX (ULLONG_MAX для strtoull()) при успешном выполнении и ошибке, вызывающая программа до вызова должна присвоить errno значение 0, а после вызова определить возникновение ошибки по ненулевому значению errno.

При помощи локалей могут приниматься строки, отличные от допустимых в локали «C» (например, может поддерживаться разделитель тысяч из текущей локали).

В BSD также есть функция

    u_quad_t strtouq(const char *nptr, char **endptr, int base);

с полностью аналогичным определением. В зависимости от длины слова в текущей архитектуре, она может быть аналогом strtoull() или strtoul().

Negative values are considered valid input and are silently converted to the equivalent unsigned long value.

ПРИМЕРЫ
Пример можно найти в справочной странице strtol(3); в ней показано использование похожих функций.

СМ. ТАКЖЕ
a64l(3), atof(3), atoi(3), atol(3), strtod(3), strtol(3), strtoumax(3)

ПЕРЕВОД
Русский перевод этой страницы руководства был сделан Alexander Golubev <fatzer2@gmail.com>, Azamat Hackimov <azamat.hackimov@gmail.com>, Hotellook, Nikita <zxcvbnm3230@mail.ru>, Spiros Georgaras <sng@hellug.gr>, Vladislav <ivladislavefimov@gmail.com>, Yuri Kozlov <yuray@komyakino.ru> и Иван Павлов <pavia00@gmail.com>

Этот перевод является бесплатной документацией; прочитайте Стандартную общественную лицензию GNU версии 3 (https://www.gnu.org/licenses/gpl-3.0.html) или более позднюю, чтобы узнать об условиях авторского права. Мы не несем НИКАКОЙ ОТВЕТСТВЕННОСТИ.

Если вы обнаружите ошибки в переводе этой страницы руководства, пожалуйста, отправьте электронное письмо на man-pages-ru-talks@lists.sourceforge.net.