Provided by: manpages-ru-dev_4.17.0-2_all bug

ИМЯ

       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⟩.