HOWTO · C
C 言語で文字列を整数に変換する
この記事では、C 言語で文字列を整数に変換するさまざまな方法を紹介します。
このページの内容
C 文字列を整数に変換する方法は、受け入れる入力とプログラムで必要な検査によって異なります。標準ライブラリには atoi()、strtol()、strtoumax() があります。入力がすでに信頼できる場合に限り atoi() を使います。不正な形式の入力や変換先の型の範囲外の値があり得る場合は、strtol() または strtoumax() で変換結果を検証してください。
C 言語で文字列を整数に変換する atoi()
atoi() は <stdlib.h> で宣言されています。先頭の空白を読み飛ばし、符号があれば読み取ってから10進数字を読み進め、数値の一部ではない最初の文字で停止します。戻り値は int ですが、解析がどこで停止したかを示したり、有効な値の 0 と変換失敗を区別したりする方法はありません。変換後の値を int で表せない場合、動作は未定義です。入力形式と値の範囲が別の方法で保証されている場合に限って使用してください。
次の例を実行します。コード中の表示文字列と出力例のラベルは、バイト単位で保持されたため英語のままです。
#include <stdio.h>
#include <stdlib.h>
int main(void) {
const char *input = "123";
int value = atoi(input);
printf("%s -> %d\n", input, value);
return 0;
}
実行結果:
123 -> 123
表示される出力文字列も、変更されていない例のコードに由来するため英語のままです。
C 言語で文字列を整数に変換する strtol()
strtol() は <stdlib.h> で宣言され、long を返します。基数には 2 から 36 を指定できます。基数 10 は10進数として読み取り、基数 0 は一般的な C の整数接頭辞を認識します。先頭の空白を読み飛ばし、数値に含まれない最初の文字で停止します。停止位置を調べるには、末尾ポインターのアドレスを渡します。末尾ポインターが入力の先頭を指したままなら、数字は変換されていません。変換後にヌル文字以外を指している場合は、入力の後ろに余分な文字があります。
strtol() を呼び出す前に errno を 0 に設定します。戻り値が LONG_MIN または LONG_MAX で、かつ errno == ERANGE なら、値が long の範囲外だったことを示します。変換先が int の場合は、キャストする前に INT_MIN と INT_MAX の範囲内かどうかも確認してください。次の例は、int で表せる完全な10進数だけを受け入れます。コード中の表示文字列と出力例のラベルは、バイト単位で保持されたため英語のままです。
#include <errno.h>
#include <limits.h>
#include <stdio.h>
#include <stdlib.h>
int main(void) {
const char *input = "123";
char *end;
errno = 0;
long parsed = strtol(input, &end, 10);
if (end == input || *end != '\0' || errno == ERANGE ||
parsed < INT_MIN || parsed > INT_MAX) {
puts("conversion failed");
return 0;
}
printf("value=%d\n", (int)parsed);
return 0;
}
実行結果:
value=123
実運用のコードでは、前後の空白や末尾の余分な文字を受け入れるかどうかを決めてください。strtol() 自体は先頭の空白を許容しますが、上記の末尾ポインターの確認では数字の後に続く文字を拒否します。出力例に表示される文字列も、変更されていないコードに由来するため英語のままです。
C 言語で文字列を整数に変換する strtoumax()
strtoumax() は <inttypes.h> で宣言され、実装が提供する最も幅の広い符号なし整数型である uintmax_t に変換します。strtol() と同様に、末尾ポインターと基数を受け取り、errno をクリアした後に errno == ERANGE で範囲超過を報告します。uintmax_t 型には <stdint.h> を、関数と PRIuMAX 書式マクロには <inttypes.h> をインクルードしてください。
符号なし変換では、先頭にマイナス符号があっても受け入れられ、関数の規則に従って符号なしの値になります。アプリケーションで非負の入力だけを許可する場合は、マイナス符号を明示的に拒否してください。次の例では、数字が少なくとも1桁あることを要求し、後続文字を拒否して、対応する書式マクロで値を表示します。コード中の表示文字列と出力例のラベルは、バイト単位で保持されたため英語のままです。
#include <ctype.h>
#include <errno.h>
#include <inttypes.h>
#include <stdint.h>
#include <stdio.h>
#include <stdlib.h>
int main(void) {
const char *input = "123";
const char *sign = input;
while (isspace((unsigned char)*sign)) {
++sign;
}
if (*sign == '-') {
puts("conversion failed");
return 0;
}
char *end;
errno = 0;
uintmax_t value = strtoumax(input, &end, 10);
if (end == input || *end != '\0' || errno == ERANGE) {
puts("conversion failed");
return 0;
}
printf("value=%" PRIuMAX "\n", value);
return 0;
}
実行結果:
value=123
戻り値は符号なしで、int より幅が広い場合があります。より狭い型に変換する前に、値が変換先の型の最大値以下であることを確認してください。出力例に表示される文字列も、変更されていないコードに由来するため英語のままです。
C 言語で文字列を整数に変換する関数の選び方
入力が信頼でき、int の範囲内に収まり、不正な入力と 0 を区別する必要がない場合は atoi() を選びます。ユーザー入力、ファイル、その他の想定形式に従わない可能性のあるデータには、末尾ポインターと errno を使って検証できる strtol() が、一般に符号付き変換のより適切な選択肢です。long の範囲と、より狭い変換先の型の範囲の両方を確認してください。
long の正の範囲を超える可能性がある非負の値には strtoumax() を選びます。数字が変換されたことを確認し、文字列全体が数値でなければならない場合は後続文字を拒否し、ERANGE を確認して、アプリケーション固有のより狭い上限も適用してください。どちらの検証可能な関数も、アプリケーションで何を許容するかは決めません。空白、符号、接頭辞、後続文字を許すかどうかを呼び出し側で定め、結果を使う前にその規則を確認する必要があります。