std::atoi、std::atol、std::atoll

ヘッダ `<cstdlib>` で定義
int atoi( const char* str );	(1)
long atol( const char* str );	(2)
long long atoll( const char* str );	(3)	(C++11以降)

strが指すバイト文字列から整数値を解釈します。暗黙の基数は常に10です。

先頭の空白文字をすべて無視し、最初の非空白文字が見つかったら、有効な整数表現を形成できるだけ多くの文字を取り込み、それらを整数値に変換します。有効な整数値は、以下の部分で構成されます。

(任意)プラスまたはマイナスの記号
数字

結果の値が表現できない場合、つまり変換された値が対応する戻り値の型の範囲外である場合、動作は未定義です。

template<typename T>
T atoi_impl(const char* str)
{
    while (std::isspace(static_cast<unsigned char>(*str)))
        ++str;
 
    bool negative = false;
 
    if (*str == '+')
        ++str;
    else if (*str == '-')
    {
        ++str;
        negative = true;
    }
 
    T result = 0;
    for (; std::isdigit(static_cast<unsigned char>(*str)); ++str)
    {
        int digit = *str - '0';
        result *= 10;
        result -= digit; // calculate in negatives to support INT_MIN, LONG_MIN,..
    }
 
    return negative ? result : -result;
}
 
int atoi(const char* str)
{
    return atoi_impl<int>(str);
}
 
long atol(const char* str)
{
    return atoi_impl<long>(str);
}
 
long long atoll(const char* str)
{
    return atoi_impl<long long>(str);
}

実際のC++ライブラリ実装は、Cライブラリのatoi、atoil、atollの実装にフォールバックします。これらは、直接実装するか（MUSL libcの場合）、strtol/strtollに委譲します（GNU libcの場合）。

[編集] 例

このコードを実行

#include <cstdlib>
#include <iostream>
 
int main()
{
    const auto data =
    {
        "42",
        "0x2A", // treated as "0" and junk "x2A", not as hexadecimal
        "3.14159",
        "31337 with words",
        "words and 2",
        "-012345",
        "10000000000" // note: out of int32_t range
    };
 
    for (const char* s : data)
    {
        const int i{std::atoi(s)};
        std::cout << "std::atoi('" << s << "') is " << i << '\n';
        if (const long long ll{std::atoll(s)}; i != ll)
            std::cout << "std::atoll('" << s << "') is " << ll << '\n';
    }
}

実行結果の例

std::atoi('42') is 42
std::atoi('0x2A') is 0
std::atoi('3.14159') is 3
std::atoi('31337 with words') is 31337
std::atoi('words and 2') is 0
std::atoi('-012345') is -12345
std::atoi('10000000000') is 1410065408
std::atoll('10000000000') is 10000000000

[編集] 関連項目

stoistolstoll (C++11)(C++11)(C++11)	文字列を符号付き整数に変換する (function) [編集]
stoulstoull (C++11)(C++11)	文字列を符号なし整数に変換する (function) [編集]
strtolstrtoll (C++11)	バイト文字列を整数値に変換する (関数) [編集]
strtoulstrtoull (C++11)	バイト文字列を符号なし整数値に変換する (関数) [編集]
strtoimaxstrtoumax (C++11)(C++11)	バイト文字列を std::intmax_t または std::uintmax_t に変換する (関数) [編集]
from_chars (C++17)	文字シーケンスを整数値または浮動小数点数値に変換する (関数) [編集]
C言語のドキュメント（atoi、atol、atoll）

コンパイラサポート
フリースタンディングとホスト
言語
標準ライブラリ
標準ライブラリヘッダー
名前付き要件
機能テストマクロ (C++20)
言語サポートライブラリ
コンセプトライブラリ (C++20)
診断ライブラリ
メモリ管理ライブラリ
メタプログラミングライブラリ (C++11)
汎用ユーティリティライブラリ
コンテナライブラリ
イテレータライブラリ
Rangesライブラリ (C++20)
アルゴリズムライブラリ
文字列ライブラリ
テキスト処理ライブラリ
数値ライブラリ
日付と時刻ライブラリ
入出力ライブラリ
ファイルシステムライブラリ (C++17)
並行サポートライブラリ (C++11)
実行制御ライブラリ (C++26)
Technical specifications (技術仕様)
シンボルインデックス
外部ライブラリ

cppreference.com

名前空間

変種

表示

操作

std::atoi、std::atol、std::atoll

目次

[編集] パラメータ

[編集] 戻り値

[編集] 実装例

[編集] 例

[編集] 関連項目

ナビゲーション

ツールボックス