[C言語] atoi関数の使い方をわかりやすく解説(文字列→数値変換)

2025-04-15更新日: 2025-04-15

C言語のatoi関数は、文字列を整数に変換するための標準ライブラリ関数です。

この関数はstdlib.hヘッダファイルに定義されており、引数として数値を表す文字列を受け取ります。

例えば、atoi("123")は整数123を返します。

ただし、atoiはエラーチェックを行わないため、変換に失敗した場合の動作は未定義です。

そのため、入力が数値であることが保証されている場合に使用するのが一般的です。

目次から探す

atoi関数とは

atoi関数の概要

atoi関数は、C言語の標準ライブラリに含まれる関数で、文字列を整数に変換するために使用されます。

atoiは ASCII to Integer の略で、文字列形式で表現された数値を整数型のデータに変換する機能を提供します。

この関数は、数値が文字列として入力される場合に便利で、特にユーザー入力やファイルから読み込んだデータを処理する際に役立ちます。

標準ライブラリのインクルード

atoi関数を使用するためには、標準ライブラリの<stdlib.h>をインクルードする必要があります。

このヘッダーファイルには、atoiを含む様々なユーティリティ関数が定義されています。

#include <stdlib.h>

atoi関数の基本的な使い方

atoi関数の基本的な使い方は非常にシンプルです。

関数は、変換したい文字列を引数として受け取り、その文字列を整数に変換して返します。

以下に基本的な使用例を示します。

#include <stdio.h>
#include <stdlib.h>
int main() {
    // 文字列を整数に変換
    char str[] = "12345";
    int num = atoi(str);
    // 結果を表示
    printf("変換された整数: %d\n", num);
    return 0;
}

変換された整数: 12345

この例では、文字列"12345"が整数12345に変換され、結果が表示されます。

atoi関数は、文字列の先頭から数値として解釈できる部分を変換し、数値以外の文字が現れた時点で変換を終了します。

したがって、"123abc"のような文字列を渡した場合、123が返されます。

atoi関数の動作

文字列から整数への変換

atoi関数は、文字列を整数に変換する際に、文字列の先頭から順に数値として解釈できる部分を変換します。

数値として解釈できる文字が続く限り、その部分を整数に変換し、最初に数値以外の文字が現れた時点で変換を終了します。

例えば、"12345abc"という文字列をatoiに渡すと、12345が整数として返されます。

変換可能な文字列の形式

atoi関数が変換可能な文字列の形式は以下の通りです：

数字のみの文字列(例："123")
数字の前に空白がある文字列(例：" 456")
数字の前に符号+または-がある文字列(例："-789")

以下の表に、変換可能な文字列の例を示します。

文字列	変換結果
`"123"`	123
`" 456"`	456
`"-789"`	-789
`"+1011"`	1011

変換できない場合の挙動

atoi関数は、変換できない文字列に対しては、数値として解釈できる部分がない場合に0を返します。

例えば、文字列が数値で始まらない場合や、完全に数値以外の文字列である場合です。

また、atoi関数はエラー処理を行わないため、変換できない文字列に対しても特別なエラーを返すことはありません。

以下に変換できない場合の例を示します。

#include <stdio.h>
#include <stdlib.h>
int main() {
    // 数値として解釈できない文字列
    char str1[] = "abc123";
    char str2[] = "hello";
    // 変換結果
    int num1 = atoi(str1);
    int num2 = atoi(str2);
    // 結果を表示
    printf("変換結果1: %d\n", num1); // 0が返される
    printf("変換結果2: %d\n", num2); // 0が返される
    return 0;
}

変換結果1: 0
変換結果2: 0

この例では、"abc123"や"hello"のような文字列は数値として解釈できる部分がないため、atoi関数は0を返します。

atoi関数の使用例

基本的な使用例

atoi関数の基本的な使用例として、ユーザーから入力された文字列を整数に変換する方法を示します。

以下のコードは、ユーザーが入力した数値を文字列として受け取り、それを整数に変換して表示します。

#include <stdio.h>
#include <stdlib.h>
int main() {
    char input[10];
    
    // ユーザーからの入力を受け取る
    printf("数値を入力してください: ");
    scanf("%s", input);
    
    // 文字列を整数に変換
    int number = atoi(input);
    
    // 結果を表示
    printf("入力された数値は: %d\n", number);
    
    return 0;
}

数値を入力してください: 42
入力された数値は: 42

この例では、ユーザーが入力した文字列がatoi関数によって整数に変換され、結果が表示されます。

複数の数値を含む文字列の変換

atoi関数は、文字列の先頭から数値として解釈できる部分のみを変換します。

そのため、複数の数値が含まれる文字列を変換する場合、最初の数値のみが変換されます。

以下の例では、文字列に複数の数値が含まれている場合の挙動を示します。

#include <stdio.h>
#include <stdlib.h>
int main() {
    char str[] = "123 456 789";
    
    // 文字列を整数に変換
    int num = atoi(str);
    
    // 結果を表示
    printf("変換された数値は: %d\n", num);
    
    return 0;
}

変換された数値は: 123

この例では、文字列"123 456 789"の最初の数値123のみが変換され、後続の数値は無視されます。

エラーハンドリングの例

atoi関数はエラー処理を行わないため、変換できない文字列に対しても0を返します。

エラーハンドリングを行うには、atoiの代わりにstrtol関数を使用することが推奨されます。

以下にstrtolを用いたエラーハンドリングの例を示します。

#include <stdio.h>
#include <stdlib.h>
#include <errno.h>
int main() {
    char str[] = "abc123";
    char *endptr;
    
    // 文字列を整数に変換
    errno = 0; // エラー番号をリセット
    long num = strtol(str, &endptr, 10);
    
    // エラーチェック
    if (errno != 0 || *endptr != '#include <stdio.h>
#include <stdlib.h>
#include <errno.h>
int main() {
char str[] = "abc123";
char *endptr;
// 文字列を整数に変換
errno = 0; // エラー番号をリセット
long num = strtol(str, &endptr, 10);
// エラーチェック
if (errno != 0 || *endptr != '\0') {
printf("変換に失敗しました。\n");
} else {
printf("変換された数値は: %ld\n", num);
}
return 0;
}') {
        printf("変換に失敗しました。\n");
    } else {
        printf("変換された数値は: %ld\n", num);
    }
    
    return 0;
}

変換に失敗しました。

この例では、strtol関数を使用して変換を試み、変換に失敗した場合にはエラーメッセージを表示します。

strtolは変換に失敗した場合にerrnoを設定し、変換できなかった部分をendptrで示すため、より安全なエラーハンドリングが可能です。

atoi関数の注意点

エラー処理がないことのリスク

atoi関数は、文字列を整数に変換する際にエラー処理を行わないため、変換に失敗しても特別なエラーを返しません。

例えば、数値として解釈できない文字列を渡した場合でも、atoiは単に0を返します。

この挙動は、プログラムのロジックに影響を与える可能性があり、特に0が有効な入力値である場合には、変換が成功したのか失敗したのかを判断するのが難しくなります。

変換できない文字列の扱い

atoi関数は、数値として解釈できない文字列に対して0を返します。

これは、数値以外の文字が文字列の先頭にある場合や、完全に数値以外の文字列である場合に発生します。

以下にその例を示します。

#include <stdio.h>
#include <stdlib.h>
int main() {
    char str1[] = "abc";
    char str2[] = "123abc";
    
    // 変換結果
    int num1 = atoi(str1);
    int num2 = atoi(str2);
    
    // 結果を表示
    printf("変換結果1: %d\n", num1); // 0が返される
    printf("変換結果2: %d\n", num2); // 123が返される
    
    return 0;
}

変換結果1: 0
変換結果2: 123

この例では、"abc"は数値として解釈できないため0が返され、"123abc"は先頭の123が変換されます。

他の変換関数との比較

atoi関数の代わりに、より安全で柔軟な変換を行うためにstrtolやsscanfなどの関数を使用することができます。

これらの関数は、エラー処理や変換の詳細な制御を可能にします。

関数名	特徴
`atoi`	簡単に使用できるが、エラー処理がない。変換できない場合は`0`を返す。
`strtol`	エラー処理が可能で、変換できなかった部分を示すポインタを返す。
`sscanf`	フォーマット指定子を使用して、複数の値を一度に変換可能。

例えば、strtolを使用すると、変換の成否を確認し、エラーが発生した場合に適切な処理を行うことができます。

sscanfは、複数の数値を含む文字列を一度に変換する際に便利です。

これらの関数を使用することで、より堅牢なプログラムを作成することができます。

atoi関数の応用例

コマンドライン引数の処理

atoi関数は、コマンドライン引数として渡された文字列を整数に変換する際に便利です。

プログラムが実行される際に、ユーザーが指定した数値を処理するために使用されます。

以下の例では、コマンドライン引数として渡された数値を整数に変換し、その結果を表示します。

#include <stdio.h>
#include <stdlib.h>
int main(int argc, char *argv[]) {
    if (argc < 2) {
        printf("数値を引数として指定してください。\n");
        return 1;
    }
    
    // コマンドライン引数を整数に変換
    int number = atoi(argv[1]);
    
    // 結果を表示
    printf("指定された数値は: %d\n", number);
    
    return 0;
}

$ ./program 42
指定された数値は: 42

この例では、プログラム実行時に数値を引数として渡し、その数値を整数に変換して表示します。

ファイルから読み込んだデータの変換

atoi関数は、ファイルから読み込んだ文字列データを整数に変換する際にも使用されます。

以下の例では、ファイルから数値を読み込み、それを整数に変換して表示します。

#include <stdio.h>
#include <stdlib.h>
int main() {
    FILE *file = fopen("numbers.txt", "r");
    if (file == NULL) {
        printf("ファイルを開けませんでした。\n");
        return 1;
    }
    
    char buffer[10];
    while (fgets(buffer, sizeof(buffer), file) != NULL) {
        // 文字列を整数に変換
        int number = atoi(buffer);
        printf("読み込んだ数値: %d\n", number);
    }
    
    fclose(file);
    return 0;
}

読み込んだ数値: 123
読み込んだ数値: 456

この例では、numbers.txtファイルから数値を読み込み、それぞれを整数に変換して表示します。

ユーザー入力の数値変換

atoi関数は、ユーザーからの入力を数値に変換する際にも役立ちます。

以下の例では、ユーザーが入力した文字列を整数に変換し、その結果を表示します。

#include <stdio.h>
#include <stdlib.h>
int main() {
    char input[10];
    
    // ユーザーからの入力を受け取る
    printf("数値を入力してください: ");
    fgets(input, sizeof(input), stdin);
    
    // 文字列を整数に変換
    int number = atoi(input);
    
    // 結果を表示
    printf("入力された数値は: %d\n", number);
    
    return 0;
}

数値を入力してください: 789
入力された数値は: 789

この例では、ユーザーが入力した文字列をatoi関数で整数に変換し、その結果を表示します。

ユーザー入力を数値として処理する際に、atoiは簡単で便利な方法です。

まとめ

atoi関数は、C言語で文字列を整数に変換するための便利な関数です。

この記事では、atoi関数の基本的な使い方や注意点、応用例について詳しく解説しました。

atoi関数は簡単に使用できますが、エラー処理がないため、変換の成否を確認する必要がある場合にはstrtolなどの他の関数を検討することが重要です。

この記事を参考に、atoi関数を適切に活用し、プログラムの信頼性を向上させてください。