_ultoa、_ultow
unsigned long 型の整数を文字列に変換します。 これらの関数のセキュリティを強化したバージョンについては、「_ultoa_s、_ultow_s」を参照してください。
char *_ultoa(
unsigned long value,
char *str,
int radix
);
wchar_t *_ultow(
unsigned long value,
wchar_t *str,
int radix
);
template <size_t size>
char *_ultoa(
unsigned long value,
char (&str)[size],
int radix
); // C++ only
template <size_t size>
wchar_t *_ultow(
unsigned long value,
wchar_t (&str)[size],
int radix
); // C++ only
パラメーター
value
変換される数値。str
結果の文字列。radix
value の基数。
戻り値
各関数は str へのポインターを返します。 エラーの戻り値はありません。
解説
_ultoa 関数は、value を null で終わる文字列に変換し、その結果 (最大 33 バイトまで) を str に格納します。 オーバーフロー チェックは実行されません。 radix は、value の基数を指定します。radix は、2 ~ 36 の範囲内で指定する必要があります。 ワイド文字を扱う場合は、_ultoa ではなく _ultow を使用します。
セキュリティに関するメモ |
---|
バッファー オーバーランを回避するには、変換された数字と後続の null 文字を格納するために十分なサイズの str バッファーを確保してください。 |
C++ では、これらの関数にテンプレートのオーバーロードがあります。このオーバーロードは、これらの関数に対応するセキュリティで保護された新しい関数を呼び出します。 詳細については、「セキュリティ保護されたテンプレート オーバーロード」を参照してください。
汎用テキスト ルーチンのマップ
TCHAR.H のルーチン |
_UNICODE および _MBCS が未定義の場合 |
_MBCS が定義されている場合 |
_UNICODE が定義されている場合 |
---|---|---|---|
_ultot |
_ultoa |
_ultoa |
_ultow |
必要条件
ルーチン |
必須ヘッダー |
---|---|
_ultoa |
<stdlib.h> |
_ultow |
<stdlib.h> または <wchar.h> |
互換性の詳細については、「C ランタイム ライブラリ」の「互換性」を参照してください。
使用例
「_itoa」の例を参照してください。