ИМЯ¶

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

БИБЛИОТЕКА¶

Стандартная библиотека языка C (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);

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.

The string may begin with an arbitrary amount of white space (as determined by isspace(3)) followed by a single optional '+' or '-' sign. If base is zero or 16, the string may then include a "0x" prefix, and the number will be read in base 16; otherwise, a zero base is taken as 10 (decimal) unless the next character is '0', in which case it is taken as 8 (octal).

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

If endptr is not NULL, strtoul() stores the address of the first invalid character in *endptr. If there were no digits at all, strtoul() stores the original value of nptr in *endptr (and returns 0). In particular, if *nptr is not '\0' but **endptr is '\0' on return, the entire string is valid.

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(): POSIX.1-2001, POSIX.1-2008, 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 (GNU General Public License - GPL, https://www.gnu.org/licenses/gpl-3.0.html версии 3 или более поздней) в отношении авторского права, но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ.

Если вы обнаружите какие-либо ошибки в переводе этой страницы руководства, пожалуйста, сообщите об этом разработчику(ам) по его(их) адресу(ам) электронной почты или по адресу списка рассылки русских переводчиков.