strtoul, _strtoul_l, wcstoul, _wcstoul_l

Převede řetězce na celočíselnou hodnotu bez znaménka.

Syntaxe

unsigned long strtoul(
   const char *strSource,
   char **endptr,
   int base
);
unsigned long _strtoul_l(
   const char *strSource,
   char **endptr,
   int base,
   _locale_t locale
);
unsigned long wcstoul(
   const wchar_t *strSource,
   wchar_t **endptr,
   int base
);
unsigned long _wcstoul_l(
   const wchar_t *strSource,
   wchar_t **endptr,
   int base,
   _locale_t locale
);

Parametry

strSource
Řetězec ukončený hodnotou null, který se má převést.

endptr
Ukazatel na znak, který zastaví prohledávání.

base
Číselný základ, který se má použít.

locale
Národní prostředí, které se má použít.

Vrácená hodnota

strtoul vrátí převedenou hodnotu, pokud existuje, nebo ULONG_MAX při přetečení. strtoul vrátí hodnotu 0, pokud nelze provést žádný převod. wcstoul vrátí hodnoty analogicky k strtoul. U obou funkcí je nastaveno, errno jestli dojde k ERANGE přetečení nebo podtečení.

Další informace o návratových kódech naleznete v tématu errno, _doserrno, _sys_errlista _sys_nerr.

Poznámky

Každá z těchto funkcí převede vstupní řetězec strSource na .unsigned long

strtoul přestane číst řetězec strSource na prvním znaku, který nedokáže rozpoznat jako součást čísla. Tento znak může být ukončující NULLnebo může být prvním číselným znakem, který je větší nebo roven base. Nastavení LC_NUMERIC kategorie národního prostředí určuje rozpoznávání znaku radix v strSource; další informace naleznete v tématu setlocale. strtoul a wcstoul použijte aktuální národní prostředí a _strtoul_l_wcstoul_l jsou shodné s tím rozdílem, že místo toho používají národní prostředí předané. Další informace naleznete v tématu Národní prostředí.

Pokud endptr není NULL, ukazatel na znak, který zastavil kontrolu, je uložen v umístění, na které endptrodkazuje . Pokud nelze provést žádný převod (nebyly nalezeny žádné platné číslice nebo byla zadána neplatná základna), hodnota strSource je uložena v umístění, na které endptrodkazuje .

wcstoul je širokoznační verze strtoul; jeho strSource argument je řetězec širokého znaku. Jinak se tyto funkce chovají stejně.

Ve výchozím nastavení je globální stav této funkce vymezen na aplikaci. Chcete-li toto chování změnit, přečtěte si téma Globální stav v CRT.

Mapování rutin obecného textu

TCHAR.H Rutinní	_UNICODE a _MBCS není definován	_MBCS Definovány	_UNICODE Definovány
_tcstoul	strtoul	strtoul	wcstoul
_tcstoul_l	strtoul_l	_strtoul_l	_wcstoul_l

strtoulstrSource očekává, že odkazuje na řetězec následujícího formuláře:

[whitespace] [{+ | -}] [0 [{ x | X }]] [digits | letters]

Může whitespace se skládat z mezery a znaků tabulátoru, které jsou ignorovány. digits jsou jedno nebo více desetinných číslic. letters jsou jedním nebo více písmeny a prostřednictvím z (nebo A prostřednictvím Z). První znak, který se nevejde do tohoto formuláře, zastaví prohledávání. Pokud base je mezi 2 a 36, použije se jako základ čísla. Pokud base je 0, počáteční znaky řetězce, na který strSource odkazuje, slouží k určení základu. Pokud je první znak 0 a druhý znak není x nebo X, řetězec se interpretuje jako osmičkové celé číslo. Pokud je první znak "0" a druhý znak je x nebo X, řetězec se interpretuje jako šestnáctkové celé číslo. Pokud je první znak 1 až 9, řetězec se interpretuje jako desetinné číslo. Písmena a prostřednictvím z (nebo A až Z) jsou přiřazeny hodnoty 10 až 35; pouze písmena, jejichž přiřazené hodnoty jsou menší, než base jsou povoleny. První znak mimo rozsah základny zastaví kontrolu. Pokud je například base 0 a první znak skenován je 0, předpokládá se osmičkové celé číslo a kontrola 8 nebo 9 zastaví kontrolu. strtoul umožňuje předponu znaménka plus (+) nebo minus-; počáteční znaménko minus označuje, že návratová hodnota je negatedovaná.

Požadavky

Rutina	Požadovaný hlavičkový soubor
strtoul	<stdlib.h>
wcstoul	<stdlib.h> nebo <wchar.h>
_strtoul_l	<stdlib.h>
_wcstoul_l	<stdlib.h> nebo <wchar.h>

Další informace o kompatibilitě najdete v tématu Kompatibilita.

Příklad

Podívejte se na příklad pro strtod.

Viz také

Převod dat
Národní prostředí
localeconv
setlocale, _wsetlocale
Funkce řetězcových k číselným hodnotám
strtod, _strtod_l, wcstod, _wcstod_l
strtol, wcstol, _strtol_l, _wcstol_l
atof, _atof_l, _wtof, _wtof_l