_ultoa_s, _ultow_s

Článek
06/09/2015

Dlouhé celé číslo bez znaménka převeďte na řetězec.Tyto verze jsou _ultoa, _ultow s vylepšení zabezpečení popsaným v Funkce zabezpečení v CRT.

errno_t _ultoa_s(
    unsigned long value,
    char *str,
    size_t sizeOfstr,
    int radix 
);
errno_t _ultow_s(
    unsigned long value,
    wchar_t *str,
    size_t sizeOfstr,
    int radix 
);
template <size_t size>
errno_t _ultoa_s(
    unsigned long value,
    char (&str)[size],
    int radix 
); // C++ only
template <size_t size>
errno_t _ultow_s(
    unsigned long value,
    wchar_t (&str)[size],
    int radix 
); // C++ only

Parametry

value
Číslo převést.
str
Výsledek řetězce.
sizeOfstr
Velikost str v bajtech pro _ultoa_s nebo slov, pro _ultow_s.
radix
Base of value.

Vrácená hodnota

Nula, pokud byla úspěšná funkce nebo kód chyby.

Poznámky

_ultoa_s Funkce převede číslice value na řetězec znaků zakončený znakem null a uloží výsledek (až 33 bajtů) str.radix Argument určuje základ value, která musí být v rozsahu 2 – 36._ultow_sje verze znaků _ultoa_s; druhý argument _ultow_s je řetězec znaků.

Pokud str je NULL ukazatele, nebo pokud sizeOfstr je menší nebo rovna nule, je vyvolána neplatný parametr popisovače, jak je popsáno v Ověření parametru.Pokud je povoleno spuštění pokračovat, vrátí tyto funkce hodnotu -1 a errno na EINVAL nebo pokud value nebo str mimo rozsah dlouhé celé číslo, budou tyto funkce vrátit -1 a nastavte errno na ERANGE.

V jazyce C++ použití těchto funkcí je zjednodušeno díky šablony přetížení; přetížení automaticky odvodit vyrovnávací paměti (není tak nutné zadat argument velikost) a jsou automaticky nahradit starší, -secure funkce s jejich protějšky novější, zabezpečené.Další informace naleznete v tématu Přetížení zabezpečení šablony.

Obecný Text rutinní mapování