std::wcstoimax, std::wcstoumax

 

C++

コンパイラサポート

フリースタンディングとホスト

言語

標準ライブラリ

標準ライブラリヘッダー

名前付き要件

機能テストマクロ (C++20)

言語サポートライブラリ

コンセプトライブラリ (C++20)

診断ライブラリ

メモリ管理ライブラリ

メタプログラミングライブラリ (C++11)

汎用ユーティリティライブラリ

コンテナライブラリ

イテレータライブラリ

Rangesライブラリ (C++20)

アルゴリズムライブラリ

文字列ライブラリ

テキスト処理ライブラリ

数値ライブラリ

日付と時刻ライブラリ

入出力ライブラリ

ファイルシステムライブラリ (C++17)

並行サポートライブラリ (C++11)

実行制御ライブラリ (C++26)

Technical specifications (技術仕様)

シンボルインデックス

外部ライブラリ

 

テキスト処理ライブラリ

ローカライズライブラリ

正規表現ライブラリ (C++11)

フォーマットライブラリ (C++20)

ヌル終端シーケンスユーティリティ

バイト文字列

マルチバイト文字列

ワイド文字列

プリミティブな数値変換

to_chars (C++17) to_chars_result (C++17) from_chars (C++17) from_chars_result (C++17) chars_format (C++17)

テキストエンコーディング識別

text_encoding (C++26)

 

ヌル終端ワイド文字列

関数
文字の分類
iswalnum iswalpha iswlower iswupper iswdigit iswxdigit wctype	iswblank (C++11) iswctype iswcntrl iswgraph iswspace iswprint iswpunct
文字操作
towlower towupper	towctrans wctrans
数値フォーマットへの変換
wcstolwcstoll (C++11)   wcstofwcstodwcstold (C++11)(C++11)	wcstoulwcstoull (C++11) wcstoimaxwcstouimax (C++11)(C++11)
文字列操作
wcslen wcscmp wcscoll wcsncmp wcschr wcsrchr	wcspbrk wcsspn wcscspn wcsstr wcstok
文字列検査
wcscpy wcsncpy wcsxfrm	wcscat wcsncat
配列操作
wmemcpy wmemmove wmemcmp	wmemchr wmemset
型 wctrans_t wctype_t wint_t	マクロ WCHAR_MIN WCHAR_MAX WEOF

 

ヘッダー <cinttypes> で定義
std::intmax_t wcstoimax( const wchar_t* nptr, wchar_t** endptr, int base );		(C++11以降)
std::uintmax_t wcstoumax( const wchar_t* nptr, wchar_t** endptr, int base );		(C++11以降)

nptrが指すワイド文字列の符号なし整数値を解釈します。

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進数とみなされます。

入力シーケンスにマイナス符号が含まれていた場合、数字のシーケンスから計算された数値は、結果の型で単項マイナス演算子のように負の値にされ、符号なし整数ラップアラウンド規則が適用されます。

endptrが指すポインタは、解釈された最後の文字の次のワイド文字を指すように設定されます。endptrがヌルポインタの場合、無視されます。

パラメータ

nptr	-	解釈されるヌル終端ワイド文字列へのポインタ
endptr	-	ワイド文字へのポインタへのポインタ
base	-	解釈される整数値の基数

戻り値

成功した場合、strの内容に対応する整数値が返されます。変換された値が対応する戻り値の型の範囲を超える場合、範囲エラーが発生し、適切に応じてINTMAX_MAX、INTMAX_MIN、UINTMAX_MAX、または​0​が返されます。変換が実行できない場合、​0​が返されます。

例

このコードを実行

#include <cinttypes>
#include <iostream>
#include <string>
 
int main()
{
    std::wstring str = L"helloworld";
    std::intmax_t val = std::wcstoimax(str.c_str(), nullptr, 36);
    std::wcout << str << " in base 36 is " << val << " in base 10\n";
 
    wchar_t* nptr;
    val = std::wcstoimax(str.c_str(), &nptr, 30);
    if (nptr != &str[0] + str.size())
        std::wcout << str << " in base 30 is invalid."
                   << " The first invalid digit is " << *nptr << '\n';
}

出力

helloworld in base 36 is 1767707668033969 in base 10
helloworld in base 30 is invalid. The first invalid digit is w

関連項目

strtoimaxstrtoumax (C++11)(C++11)	バイト文字列を std::intmax_t または std::uintmax_t に変換する (関数)
wcstolwcstoll	ワイド文字列を整数値に変換する (関数)
wcstoulwcstoull	ワイド文字列を符号なし整数値に変換する (関数)
Cドキュメント wcstoimax, wcstoumax