std::strtol, std::strtoll

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 のロケールによって、追加の数値形式が受理されるかもしれません。

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

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

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

str が空または期待される形式を持たない場合、変換は行われず、 (str_end が NULL でなければ) str の値が str_end の指すオブジェクトに格納されます。

[編集] 引数

[編集] 戻り値

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

[編集] 例

#include <cerrno>
#include <cstdlib>
#include <iomanip>
#include <iostream>
#include <string>
 
int main()
{
    const char* p = "10 200000000000000000000000000000 30 -40";
    std::cout << "Parsing " << std::quoted(p) << ":\n";
 
    for (;;)
    {
        // errno はエラーがあるかどうかに関わらず、 
        // ライブラリ関数への呼び出しで任意の非ゼロ値に設定されることが可能だから、
        // strtol が設定するエラーを検査するために、これをクリアする必要があります
        errno = 0;
        char* p_end;
        const long i = std::strtol(p, &p_end, 10);
        if (p == p_end)
            break;
 
        const bool range_error = errno == ERANGE;
        const std::string extracted(p, p_end - p);
        p = p_end;
 
        std::cout << "Extracted " << std::quoted(extracted)
                  << ", strtol returned " << i << '.';
        if (range_error)
            std::cout << " Range error occurred.";
 
        std::cout << '\n';
    }
}

Parsing "10 200000000000000000000000000000 30 -40":
Extracted "10", strtol returned 10.
Extracted " 200000000000000000000000000000", strtol returned 9223372036854775807. Range error occurred.
Extracted " 30", strtol returned 30.
Extracted " -40", strtol returned -40.

[編集] 関連項目