_ultoa_s _ultow_s
將不帶正負號的長整數轉換為字串。這些是舊版_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
大小的str以位元組為單位的_ultoa_s或特定的文字的_ultow_s。radix
Base of value.
傳回值
如果函式成功的零或一個錯誤碼。
備註
_ultoa_s函式將轉換的數字value為 null 結尾字元字串，並將結果 (最多可有 33 個位元組) 儲存在str。radix引數指定的基底value，它必須介於 2 – 36。_ultow_s寬字元版本的_ultoa_s。 第二個引數的_ultow_s是寬字元字串。
如果str是NULL指標，或者如果sizeOfstr小於或等於為零，無效的參數處理常式會叫用，如所述參數驗證。如果執行，則允許繼續執行，這些函數會傳回-1 並設定errno到EINVAL 或value或str超出長整數的範圍，這些函式會傳回-1，並設定errno到ERANGE。
在 C++ 中，使用這些函式已經過簡化的樣板的多載 ； 多載可以自動推斷緩衝區長度 (而不必指定 size 引數)，它們可以自動取代較舊的、 不安全的函式與其較新的、 安全的對應項目。如需詳細資訊，請參閱 安全範本多載。
泛用文字常式對應
TCHAR。H 常式 |
_UNICODE & 未定義的 _MBCS |
定義的 _MBCS |
定義 _unicode 之後 |
|---|---|---|---|
_ultot_s |
_ultoa_s |
_ultoa_s |
_ultow_s |
需求
常式 |
所需的標頭 |
|---|---|
_ultoa_s |
<stdlib.h> |
_ultow_s |
<stdlib.h> |
其他的相容性資訊，請參閱相容性在簡介中。