_ltoa_s, _ltow_s

Článek
06/09/2015

Dlouhé celé číslo se převede na řetězec.Tyto verze jsou _ltoa, _ltow s vylepšení zabezpečení popsaným v Funkce zabezpečení v CRT.

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

Parametry

value
Číslo převést.
str
Vyrovnávací paměť pro výsledný řetězec.
sizeOfstr
Velikost str v bajtech pro _ltoa_s nebo slov, pro _ltow_s.
radix
Base of value.

Vrácená hodnota

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

Poznámky

_ltoa_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.Pokud radix se rovná 10 a value je záporné, je první znak řetězce uložené znaménko minus (-)._ltow_sje verze znaků _ltoa_s; druhý argument _ltow_s je řetězec znaků.

Pokud str je NULL ukazatel nebo sizeOfstr je menší nebo rovna nule, tyto funkce vyvolat obslužnou rutinu neplatný parametr popsaným 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, vrátí tyto funkce hodnota -1 a nastavit 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í