std::wcstol, std::wcstoll

 

C++

言語

標準ライブラリヘッダ

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

名前付き要件

言語サポートライブラリ

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

診断ライブラリ

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

文字列ライブラリ

コンテナライブラリ

イテレータライブラリ

範囲ライブラリ (C++20)

アルゴリズムライブラリ

数値演算ライブラリ

ローカライゼーションライブラリ

入出力ライブラリ

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

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

アトミック操作ライブラリ (C++11)

スレッドサポートライブラリ (C++11)

技術仕様書

 

文字列ライブラリ

ヌル終端文字列

バイト文字列

マルチバイト文字列

ワイド文字列

クラス

basic_string

basic_string_view (C++17)

char_traits

 

ヌル終端ワイド文字列

関数
文字操作
iswalnum iswalpha iswlower iswupper iswdigit iswxdigit iswblank (C++11) wctype iswctype	iswcntrl iswgraph iswspace iswprint iswpunct towlower towupper wctrans towctrans
数値形式への変換
wcstolwcstoll (C++11) wcstoulwcstoull (C++11)	wcstofwcstodwcstold (C++11)(C++11) wcstoimaxwcstouimax (C++11)(C++11)
文字列操作
wcslen wcscpy wcsncpy wcscat wcsncat wcscmp wcscoll wcsncmp	wcsxfrm wcschr wcsrchr wcspbrk wcsspn wcscspn wcsstr wcstok
配列操作
wmemcpy
wmemmove
wmemcmp
wmemchr
wmemset

 

<tbody> </tbody>

ヘッダ <cwchar> で定義
long wcstol( const wchar_t* str, wchar_t** str_end, int base );
long long wcstoll( const wchar_t* str, wchar_t** str_end, int base );		(C++11以上)

str の指すワイド文字列内の整数値を解釈します。

最初の非ホワイトスペース文字が見つかるまで、あらゆるホワイトスペース文字を破棄します (ホワイトスペースは isspace() を呼ぶことによって識別されます)。 その後、有効な　base 進数の整数表現を形成する文字を可能な限り多く読み込み、それを整数値に変換します。 有効な整数値は以下のように構成されます。

• (オプション) 正または負の符号
• (オプション) 8進数を表す接頭辞 0 (基数が 8 または 0 の場合のみ)
• (オプション) 16進数を表す接頭辞 0x または 0X (基数が 16 または 0 の場合のみ)
• 数字の並び

基数に対する有効な値の集合は {0,2,3,...,36} です。 2進数の整数に対する有効な数字の集合は {0,1} で、3進数に対しては {0,1,2} で、以下同様です。 10 より大きな基数に対しては、有効な数字にアルファベット文字が含まれます。11進数用の Aa から始まり、36進数用の Zz までです。 大文字小文字の違いは無視されます。

現在設定されている C のstd::setlocaleによって、追加の数値形式が受理されるかもしれません。

base の値が 0 の場合、基数は自動検出されます。 接頭辞が 0 であれば8進数、 0x または 0X であれば16進数、そうでなければ10進数です。

入力列の一部に負の符号があった場合、結果の型で単項マイナス演算子によって行われたかのように、その数字列から計算された数値の符号が反転されます。

この関数は str_end の指すポインタを、解釈した最後の文字の次のワイド文字を指すように設定します。 str_end が NULL の場合は無視されます。

引数

str	-	解釈されるヌル終端ワイド文字列を指すポインタ
str_end	-	ワイド文字へのポインタへのポインタ
base	-	解釈される整数値の基数

戻り値

成功した場合は str の内容に対応する整数値。 変換後の値が戻り値の型に対応する範囲外の場合は、値域エラーが発生し、 LONG_MAX、 LONG_MIN、 LLONG_MAX または LLONG_MIN が返されます。 変換が行えない場合は、 0 が返されます。

例

Run this code

#include <iostream>
#include <string>
#include <errno.h>
#include <cwchar>

int main()
{
    const wchar_t* p = L"10 200000000000000000000000000000 30 -40";
    wchar_t *end;
    std::wcout << "Parsing L'" << p << "':\n";
    for (long i = std::wcstol(p, &end, 10);
         p != end;
         i = std::wcstol(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 9223372036854775807
' 30' -> 30
' -40' -> -40

関連項目

strtolstrtoll (C++11)	バイト文字列を整数値に変換します (関数)
wcstoulwcstoull	ワイド文字列を符号なし整数値に変換します (関数)
wcstol, wcstoll の C言語リファレンス