_ultoa_s、_ultow_s

發行項
06/09/2015

轉換成不帶正負號的長整數的字串。這些是 _ultoa、_ultow 的安全性增強版本，如 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

參數

value
被轉換的數字。
str
字串的結果。
sizeOfstr
_ultoa_s以位元組為單位的 str 大小，或 _ultow_s以字為單位的大小。
radix
value的基底。

傳回值

如果函式成功，回傳零，反之為錯誤碼。

備註

_ultoa_s 函式轉換 value 中的字元至以 null 結尾的字元字串並將結果儲存至 str (至多33位元組)。 radix 引數指定 value的基底，必須介於 2 – 36 之間。 _ultow_s 是 _ultoa_s 的寬字元版本；_ultow_s 的第二引數是寬字元字串。

如果 str 是 NULL 指標，或者sizeOfstr小於或等於零，將呼叫無效的參數處理常式，如參數驗證中所述。如果允許繼續執行，這些函式傳回 -1 並將 errno 設為 EINVAL ，或是 value 或 str 超過長整數的範圍，這些函式會傳回 -1 並將errno 設定為 ERANGE。

C++ 利用多載樣板簡化了這些函式的使用方式。多載可自動推斷緩衝區長度 (因而不須指定大小引數)，也可以將不安全的舊函式自動取代成較新且安全的對應函式。如需詳細資訊，請參閱安全範本多載。

一般文字常式對應