std:: strtoimax, std:: strtoumax

nptr が指すバイト文字列の整数値を解釈します。

空白文字（ std::isspace を呼び出すことで識別される）を最初の非空白文字が見つかるまで破棄し、その後有効な base-n （n= 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 locale によって、追加の数値フォーマットが受け入れられる場合があります。

base の値が ​ 0 ​ の場合、数値の基数は自動検出されます：プレフィックスが 0 の場合は8進数、プレフィックスが 0x または 0X の場合は16進数、それ以外の場合は10進数となります。

マイナス記号が入力シーケンスの一部であった場合、数字のシーケンスから計算された数値は、結果の型における 単項マイナス によって否定されたかのように処理されます。

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

nptr が空であるか、期待される形式を持たない場合、変換は実行されず、（ enptr がnullポインタでない場合） nptr の値が endptr が指すオブジェクトに格納されます。

パラメータ

戻り値

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

例

#include <cinttypes>
#include <iostream>
#include <string>
int main()
{
    std::string str = "helloworld";
    std::intmax_t val = std::strtoimax(str.c_str(), nullptr, 36);
    std::cout << str << " in base 36 is " << val << " in base 10\n";
    char* nptr;
    val = std::strtoimax(str.c_str(), &nptr, 30);
    if (nptr != &str[0] + str.size())
        std::cout << 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'

関連項目