_ultoa_s, _ultow_s

Artykuł
06/09/2015

Niepodpisane liczba całkowita długa należy przekonwertować na ciąg.Są to wersje _ultoa, _ultow z rozszerzeń zabezpieczeń opisane w Funkcje zabezpieczeń w 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
Liczby są konwertowane.
str
Ciąg wyniku.
sizeOfstr
Rozmiar str w bajtach dla _ultoa_s lub wyrazy, aby _ultow_s.
radix
Base of value.

Wartość zwracana

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

Uwagi

_ultoa_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._ultow_sjest to wersja szerokiego znaku _ultoa_s; drugi argument _ultow_s jest ciągi szerokich znaków.

Jeśli str jest NULL wskaźnik, lub jeśli sizeOfstr jest mniejsza lub równa zeru, nieprawidłowy parametr wywoływana jest funkcja obsługi, zgodnie z opisem w Sprawdzanie poprawności parametru.Jeśli wykonanie może kontynuować, funkcje te zwracają wartość -1 i errno do EINVAL lub jeśli value lub str poza zakresem liczba całkowita długa, zwróci -1 i ustawić te funkcje 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