std::wcstoul, std::wcstoull
| ヘッダ <cwchar> で定義 |
||
| unsigned long wcstoul ( const wchar_t* str, wchar_t** str_end, int base ); |
||
| unsigned long long wcstoull( const wchar_t* str, wchar_t** str_end, int base ); |
(C++11以降) | |
str で指されるワイド文字列内の符号なし整数値を解釈します。
まず、std::iswspace の呼び出しによって識別される空白文字をすべて破棄し、次に最初の空白でない文字が見つかるまで、有効な 基数-n (n=base) 符号なし整数表現を形成するために可能な限り多くの文字を読み取り、それらを整数値に変換します。有効な符号なし整数値は、次の部分で構成されます。
- (任意)プラスまたはマイナスの記号
- (オプション) 8進数を表す接頭辞（
0）（基数が8または0の場合にのみ適用されます） - (オプション) 16進数を表す接頭辞（
0xまたは0X）（基数が16または0の場合にのみ適用されます） - 数字のシーケンス
baseの有効な値のセットは{0, 2, 3, ..., 36}です。基数2の整数の有効な数字のセットは{0, 1}、基数3の整数は{0, 1, 2}などです。10より大きい基数では、有効な数字にはアルファベット文字が含まれ、基数11の整数ではAaから始まり、基数36の整数ではZzまでとなります。大文字・小文字は区別されません。
現在インストールされているC ロケールによって、追加の数値形式が受け入れられる場合があります。
baseの値が0の場合、数値基数は自動検出されます。接頭辞が0の場合は8進数、接頭辞が0xまたは0Xの場合は16進数、それ以外の場合は10進数とみなされます。
入力シーケンスにマイナス符号が含まれていた場合、数字のシーケンスから計算された数値は、結果の型で単項マイナス演算子のように負の値にされ、符号なし整数ラップアラウンド規則が適用されます。
これらの関数は、str_endが指すポインタを、解釈された最後の文字の次のワイド文字を指すように設定します。str_endがヌルポインタの場合、無視されます。
目次 |
[編集] パラメータ
| str | - | 解釈されるヌル終端ワイド文字列へのポインタ |
| str_end | - | ワイド文字へのポインタへのポインタ |
| base | - | 解釈される整数値の基数 |
[編集] 戻り値
成功した場合、str の内容に対応する整数値。変換された値が対応する戻り値の型の範囲を超える場合、範囲エラーが発生し、ULONG_MAX または ULLONG_MAX が返されます。変換が実行できなかった場合は、0 が返されます。
[編集] 例
#include <cwchar> #include <errno.h> #include <iostream> #include <string> int main() { const wchar_t* p = L"10 200000000000000000000000000000 30 40"; wchar_t* end; std::wcout << "Parsing L'" << p << "':\n"; for (unsigned long i = std::wcstoul(p, &end, 10); p != end; i = std::wcstoul(p, &end, 10)) { std::wcout << '\'' << std::wstring(p, end - p) << "' -> "; p = end; if (errno == ERANGE) { std::wcout << "range error, got "; errno = 0; } std::wcout << i << '\n'; } }
実行結果の例
Parsing L'10 200000000000000000000000000000 30 40': '10' -> 10 ' 200000000000000000000000000000' -> range error, got 18446744073709551615 ' 30' -> 30 ' 40' -> 40
[編集] 関連項目
| (C++11) |
バイト文字列を符号なし整数値に変換する (関数) |
| ワイド文字列を整数値に変換する (関数) | |
| C のドキュメント (wcstoul, wcstoull)
| |
