HOWTO · C++
C++ で文字列配列を Int に変換する方法
この記事では、C++ で char 配列を int 型に変換する方法を示します。
このページの内容
null 終端の char 配列には、整数を表すテキストを格納できます。C++ にはそのテキストを解析する方法がいくつかありますが、エラーの報告方法や、数値の後に別の文字が続く入力を受け入れるかどうかは関数によって異なります。入力が信頼できるか、配列全体が有効な数値でなければならないかに応じて選びましょう。
例では 10 進数の入力を使います。数値の先頭部分を変換できても、すべての文字が消費されたとは限りません。たとえば "23323tail" を解析すると 23323 を得て、tail は未解析のまま残ることがあります。入力全体が数値である必要がある場合は、変換結果だけでなく、解析が終了した位置も確認してください。
std::strtol 関数で char 配列を int に変換する
std::strtol は null 終端の文字列を解析し、long を返します。第 3 引数で基数を指定します。10 進数には 10、16 進数には 16 を使い、接頭辞から基数を判定するには 0 を指定します。基数に 0 以外を指定する場合、有効な範囲は 2 から 36 です。
第 2 引数には、消費されなかった最初の文字を指すポインターが格納されます。入力の先頭を指したままなら、数字を解析できていません。終端の null 文字を指していれば、文字列全体が消費されています。呼び出し前に errno をゼロに設定し、呼び出し後に ERANGE を確認すると、結果が long の範囲外かどうかを検出できます。結果は long なので、int に格納する前に std::numeric_limits<int>::min() と max() の範囲内かどうかも比較してください。
この例を実行します。null 終端の文字配列に格納された 10 進数のテキストを使い、解析した整数を出力します。
このセクションのコードと表示されるラベルや出力は英語のままです。
#include <cerrno>
#include <cstdlib>
#include <iostream>
#include <limits>
int main() {
const char input[] = "23323";
char* end = nullptr;
errno = 0;
const long parsed = std::strtol(input, &end, 10);
if (end == input || *end != '\0' || errno == ERANGE ||
parsed < std::numeric_limits<int>::min() ||
parsed > std::numeric_limits<int>::max()) {
std::cout << "Could not convert the complete input.\n";
return 0;
}
const int value = static_cast<int>(parsed);
std::cout << value << '\n';
}
この成功ケースの実行は終了コード 0 で終了し、次の結果を出力しました。
23323
この実行で確認できるのは、この有効な入力の場合だけです。変換の失敗や範囲外の値に対する動作を示すものではありません。本番の入力では各チェックを残してください。これらのチェックにより、変換できる数字がない場合、未解析の文字が残る場合、long の範囲を超える場合、値を int に格納できない場合を区別できます。
std::atoi 関数で char 配列を int に変換する
入力がすでに信頼でき、正しい形式である場合は、std::atoi が簡潔な選択肢になります。
int value = std::atoi(input);
先頭の空白文字と任意の符号を受け入れ、その後に続く 10 進数字を解析します。他の先頭部分解析関数と同様に、数字以外の文字で解析を止め、残りの文字を無視することがあります。有効なゼロと変換失敗を確実に区別する方法や、範囲エラーを知らせる有用な仕組みはありません。解析した値を int で表せない場合、動作は未定義です。検証していない数値入力や信頼できない数値入力に std::atoi を使わないでください。入力が不正な形式や範囲外である可能性がある場合、または呼び出し元で変換の診断情報や明示的な int の範囲チェックが必要な場合は、std::strtol を使います。
std::sscanf 関数で char 配列を int に変換する
std::sscanf はテキストに書式を適用し、成功した変換の数を報告します。整数を 1 つ読み取る場合は、変換先を使う前に戻り値が 1 であることを確認してください。
int value = 0; int converted = std::sscanf(input, "%d", &value);
%d は先頭の空白文字と任意の符号を受け入れ、その後に続く 10 進数字を読み取ります。末尾にテキストが残っていても、先頭部分の解析に成功することがあります。入力全体が消費されたことを確認するには、書式による追加チェックを行うか、別の解析方法を使ってください。変換先には書き込み可能な int オブジェクトを指定し、変換数で変換の成功を確認できるまでは読み取らないでください。変換数を確認しても、表現できない値を安全に扱えるわけではありません。一致した値を int で表せない場合、動作は未定義です。範囲外の可能性がある未検証または信頼できない数値入力に %d を使わないでください。この単純な変換では、std::strtol を使うほうが解析終了位置と値の範囲を明示的に確認できます。
ループを使って char 配列を int に変換する
受け入れる構文を独自に定める必要がある場合は、ループが適しています。まず、許可する構文を決めてください。たとえば 10 進数の解析器なら、先頭の + または - は任意とし、数字を 1 つ以上要求し、それ以外の文字はすべて拒否できます。また、各乗算と加算の前に、次の数字を加えても選択した整数型の範囲内に収まるかを確認する必要があります。確認しないと、符号付きオーバーフローによって結果が誤ったり、動作が未定義になったりする可能性があります。
任意の非数字を飛ばして、その後の数字を追加してはいけません。"23tail4" を 234 にするのは文字の選別であり、整数の解析ではありません。独自の解析器では、符号の位置、数字の検証、入力全体の消費、オーバーフローをすべて扱う必要があります。独自の規則が必要でない限り、std::strtol とその終了位置を使ってください。
まとめ
一般的な変換には std::strtol を使うのがおすすめです。解析の停止位置と long の範囲エラーを検出する手段が得られ、変換前に結果を int の上限・下限と比較できます。詳細な診断が不要で、入力が信頼でき正しい形式である場合に限り、std::atoi を使ってください。書式付きの解析が便利な場合は std::sscanf を選び、変換数を確認します。プログラムで意図的に異なる入力規則が必要な場合はループを使い、符号、数字、入力全体の消費、オーバーフローを明示的に検証してください。