_ltoa_s, _ltow_s

Artykuł
06/09/2015

Konwertuje ciąg liczba całkowita długa.Są to wersje _ltoa, _ltow z rozszerzeń zabezpieczeń opisane w Funkcje zabezpieczeń w 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
Liczby są konwertowane.
str
Bufor dla wynikowy ciąg znaków.
sizeOfstr
Rozmiar str w bajtach dla _ltoa_s lub wyrazy, aby _ltow_s.
radix
Base of value.

Wartość zwracana

Zero, jeśli funkcja zakończyła się pomyślnie lub kod błędu.

Uwagi

_ltoa_s Funkcja konwertuje cyfry value do ciągu zakończonego znakiem null i zapisuje wynik (bajtów do 33) w str.radix Argument określa podstawy value, które muszą być w zakresie 2 – 36.Jeśli radix jest równe 10 i value jest ujemna, pierwszego znaku ciągu przechowywanych jest znak minus (-)._ltow_sjest to wersja szerokiego znaku _ltoa_s; drugi argument _ltow_s jest ciągi szerokich znaków.

Jeśli str jest NULL wskaźnik lub sizeOfstr jest mniejsza lub równa zero, te funkcje wywołać funkcję obsługi nieprawidłowy parametr zgodnie z opisem w Sprawdzanie poprawności parametru.Jeśli wykonanie może kontynuować, funkcje te zwracają wartość -1 i ustawić errno do EINVAL lub jeśli value lub str poza zakresem liczba całkowita długa, funkcje te zwracają wartość -1 i errno do ERANGE.

W języku C++ korzystając z tych funkcji jest uproszczona poprzez overloads szablonu; overloads można automatycznie rozpoznać długość buforu (eliminując konieczność należy określić argument rozmiar) i automatycznie można zastąpić starszych, które nie są bezpieczne funkcje z ich odpowiednikami nowsze, bezpieczne.Aby uzyskać więcej informacji, zobacz Przeciążenia bezpiecznych szablonów.

Tekst rodzajowy rutynowych mapowania