C++ プログラミング：std::atoi を使って Strings を数値に変換する

C++ の std::atoi と Strings

使い方

std::atoi は非常にシンプルで、以下の形式で使用されます。

int number = std::atoi(str.c_str());

• number は変換結果を格納する変数 (整数型)
• str は変換したい文字列 (std::string 型)
• c_str() は std::string 型を const char* 型に変換する関数

例

std::string str = "1234";
int number = std::atoi(str.c_str());

// number は 1234 になる

注意点

• std::atoi は、文字列の先頭から空白文字を除いて、最初の数字からなる部分を変換します。
• 数字以外の文字が最初に現れると、その時点で変換が停止し、それ以降の文字は無視されます。
• 変換結果が整数型の範囲を超えると、処理が異常終了する可能性があります。

代替手段

std::atoi 以外にも、文字列から整数への変換にはいくつかの方法があります。

• std::stringstream を使用する方法: より安全で柔軟な方法
• std::stol / std::stoll / std::stoull を使用する方法: 10進数 / 16進数 / 10進数 (符号なし) への変換

• std::atoi は C 言語の atoi 関数の C++ 版です。
• std::atoi は非推奨 (deprecated) となっており、代わりに std::stoi などの使用が推奨されています。

std::atoi を使ったサンプルコード

#include <iostream>

int main() {
  std::string str = "1234";
  int number = std::atoi(str.c_str());

  std::cout << "str: " << str << std::endl;
  std::cout << "number: " << number << std::endl;

  return 0;
}

出力

str: 1234
number: 1234

空白文字を含む文字列

#include <iostream>

int main() {
  std::string str = "  1234  ";
  int number = std::atoi(str.c_str());

  std::cout << "str: " << str << std::endl;
  std::cout << "number: " << number << std::endl;

  return 0;
}

出力

str:   1234  
number: 1234

数字以外の文字を含む文字列

#include <iostream>

int main() {
  std::string str = "1234abc";
  int number = std::atoi(str.c_str());

  std::cout << "str: " << str << std::endl;
  std::cout << "number: " << number << std::endl;

  return 0;
}

出力

str: 1234abc
number: 1234

変換結果が範囲外の値

#include <iostream>
#include <limits>

int main() {
  std::string str = "2147483648"; // int型の最大値 + 1
  int number = std::atoi(str.c_str());

  std::cout << "str: " << str << std::endl;
  std::cout << "number: " << number << std::endl;

  return 0;
}

出力

str: 2147483648
number: -2147483648

std::stringstream を使用した方法

#include <iostream>
#include <sstream>

int main() {
  std::string str = "1234.56";
  int number;

  std::stringstream ss(str);
  ss >> number;

  std::cout << "str: " << str << std::endl;
  std::cout << "number: " << number << std::endl;

  return 0;
}

出力

str: 1234.56
number: 1234

std::stoi / std::stoll / std::stoull を使用する方法

#include <iostream>
#include <string>

int main() {
  std::string str = "1234";
  int number = std::stoi(str);

  std::cout << "str: " << str << std::endl;
  std::cout << "number: " << number << std::endl;

  return 0;
}

出力

str: 1234
number: 1234

これらのサンプルコードは、std::atoi の使い方を理解するのに役立ちます。

std::atoi 以外の文字列から整数への変換方法

std::stringstream は、文字列とストリーム間の変換を行うクラスです。std::stringstream を使用して、文字列を整数に変換することができます。

例

#include <iostream>
#include <sstream>

int main() {
  std::string str = "1234.56";
  int number;

  std::stringstream ss(str);
  ss >> number;

  std::cout << "str: " << str << std::endl;
  std::cout << "number: " << number << std::endl;

  return 0;
}

出力

str: 1234.56
number: 1234

std::stoi / std::stoll / std::stoull

C++11 以降では、std::stoi / std::stoll / std::stoull を使用して、文字列を整数に変換することができます。これらの関数は、それぞれ 10 進数、16 進数、10 進数 (符号なし) の文字列を整数に変換します。

例

#include <iostream>
#include <string>

int main() {
  std::string str = "1234";
  int number = std::stoi(str);

  std::cout << "str: " << str << std::endl;
  std::cout << "number: " << number << std::endl;

  return 0;
}

出力

str: 1234
number: 1234

その他の方法

上記以外にも、以下のような方法があります。

• 手動で変換する
• 自作の関数を作成する
• ライブラリを使用する

それぞれの方法にはメリットとデメリットがあります。

std::stringstream は比較的シンプルで使いやすい方法です。

std::stoi/std::stoll/std::stoull` は、より効率的で安全な方法です。