_ultoa_s, _ultow_s

Makale
06/09/2015

İşaretsiz uzun tamsayı bir dizeye dönüştürür.Bunlar sürümleridir _ultoa, _ultow açıklandığı gibi güvenlik geliştirmeleri ile CRT'deki Güvenlik Özellikleri.

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

Parametreler

value
Dönüştürülecek sayı.
str
Sonuç dize.
sizeOfstr
Boyutunu str bayt _ultoa_s için sözcükleri veya _ultow_s.
radix
Base of value.

Dönüş Değeri

İşlev başarılı olursa sıfır veya bir hata kodu.

Notlar

_ultoa_s İşlevi dönüştürür sayılardan value biten karakter dizesine sonucu (en çok 33 bayt) depolar ve str.radix Bağımsız değişkeni belirtir tabanı value, hangi 2-36 aralığında olmalıdır._ultow_sgeniş karakter sürümü _ultoa_s; İkinci değişkeni, _ultow_s geniş karakter dizeleri olur.

str Olan bir NULL işaretçisi, veya sizeOfstr küçük veya eşit olduğu sıfır olarak geçersiz parametre işleyicisi, açıklandığı şekilde çağrılır Parametre Doğrulama.Yürütülmesine devam etmek için izin verilmişse, bu işlevler -1 geri dönmek ve errno için EINVAL veya value veya str uzun tamsayı aralık dışında bu işlevler -1 dönün ve set errno için ERANGE.

C++'da, bu işlevler tarafından şablon aşırı kolaylaştırılmıştır; aşırı arabellek uzunluğu otomatik olarak gerçekleştirip (size baðýmsýz deðiþkeni belirtmek gereğini ortadan kaldırır) ve bunlar otomatik olarak yeni, güvenli karşılıkları ile eski, güvenli olmayan işlevler değiştirebilirsiniz.Daha fazla bilgi için bkz. Güvenli Şablon Aşırı Yüklemeleri.

Genel metin yordamı eşlemeleri