C言語のコマンドライン引数とは？使い方を初心者向けに徹底解説-Next Hello

この記事では、C言語のコマンドライン引数について、ゼロから丁寧に解説していきます。

プログラムを作っていると、実行するたびに同じ動きしかしない…なんてこと、ありますよね？ファイル名を毎回ソースコードに書くのも、正直ちょっと面倒くさい…。

そんな悩みを解決してくれるのが、今回紹介するコマンドライン引数なんです。これを使えば、プログラムを実行するときに、外から情報を与えて動きをコントロールできるようになります。

この記事を読めば、コマンドライン引数の基本から使い方、注意点までバッチリわかります！

この記事で学べること

コマンドライン引数が一体何なのか
プログラムのどこで、どうやって受け取るのか (`argc`, `argv` の秘密）
実際に引数を使ったプログラムの書き方と動かし方
引数を使うときに気をつけるべきこと

さあ、一緒にコマンドライン引数の世界を探検して、あなたのC言語プログラムをもっとパワーアップさせちゃいましょう！

C言語のコマンドライン引数とは？

さて、まず最初のギモン、コマンドライン引数って一体何者なんでしょう？

すごく簡単に言うと、プログラムを実行するときに、プログラム名の後ろにくっつけて渡すことができる追加情報（文字列）のことです。

例えば、ターミナル（黒い画面のことですね）でプログラムを実行するとき、こんな風に書いたりしますよね。

./myprogram

これが、引数なしの実行です。コマンドライン引数を使うと、こんな風に書けます。

./myprogram input.txt option1

この `input.txt` とか `option1` が、コマンドライン引数です。プログラムの中から、この `input.txt` や `option1` という文字列を受け取って、処理に使うことができるんです。

じゃあ、なぜこれを使うと便利なのでしょう？

プログラムを再コンパイルせずに動作を変えられる
ソースコードを書き換えなくても、実行時の引数を変えるだけで、処理するファイルを変えたり、特定の機能のオン・オフを切り替えたりできます。これはかなり楽チン！
ファイル名を指定できる
例えば、画像処理プログラムなら処理したい画像ファイル名を引数で渡したり、テキストエディタなら開きたいファイル名を渡したりできます。
オプションを設定できる
プログラムの細かい動作を、引数を使って指定できます。例えば、`-v` オプションを付けたら詳細なログを出す、とかですね。

要するに、プログラムをもっと柔軟に、そして自動化しやすくするための仕組みなんです。これを使えると、プログラミングの幅がぐっと広がりますよ！

C言語でコマンドライン引数を受け取る仕組み（argcとargv）

コマンドライン引数が便利なのはわかったけど、じゃあC言語のプログラムの中では、どうやってその情報を受け取るのでしょうか？

実は、いつも使っている `main` 関数に、その秘密が隠されています。

皆さんがよく見る `main` 関数は `int main(void)` かもしれませんが、コマンドライン引数を受け取る場合は、ちょっと形が変わります。これです！

int main(int argc, char *argv[]) {
  // ここにプログラムの処理を書く
  return 0;
}

見慣れない `int argc` と `char *argv[]` が登場しましたね。

この二人が、コマンドライン引数を受け取るための特別な存在なんです。それぞれにちゃんと役割があります。一つずつ見ていきましょう！

引数の「個数」を知るための `argc`

`argc` は、argument count（アーギュメントカウント） の略で、その名の通り、コマンドライン引数として渡されたものが「全部でいくつあるか」を教えてくれる整数（`int`型）の変数です。

ここで一つポイント！ `argc` が数えるのは、プログラム自身の名前も含めた個数になります。

例を見てみましょう。

実行コマンド: `./myprogram`
→ `argc` の値は 1 (プログラム名だけ)
実行コマンド: `./myprogram hello`
→ `argc` の値は 2 (プログラム名 + "hello")
実行コマンド: `./myprogram file.txt -o`
→ `argc` の値は 3 (プログラム名 + "file.txt" + "-o")

こんな感じで、プログラム名と、その後ろについている引数の数を合計したものが `argc` に入ります。これで、いくつの情報が渡されたかを知ることができるわけですね。

引数の「内容（文字列）」を格納する `argv`

`argv` は、argument vector（アーギュメントベクター） の略で、渡されたコマンドライン引数の「実際の文字列」が格納されている場所です。

データ型を見ると `char *argv[]` となっていて、ちょっと難しく見えるかもしれません。これは、文字列（`char *`）を要素として持つ配列だと考えてください。文字の配列（つまり文字列）が、さらに配列になっているイメージです。

`argv` 配列の中身は、次のようになっています。

`argv[0]` : プログラム自身の名前（文字列）
`argv[1]` : １番目の引数（文字列）
`argv[2]` : ２番目の引数（文字列）
...
`argv[argc - 1]` : 最後の引数（文字列）

重要なのは、`argv` の各要素はすべて文字列 (`char *`) だということです。たとえ `123` のように数字に見える引数を渡したとしても、プログラムの中では文字列 "123" として扱われます。

簡単な図でイメージしてみましょう。もし `./myprogram apple orange` と実行したら、`argc` は `3` で、`argv` はこんな感じになります。

argv[0] --> "./myprogram" (プログラム名)
argv[1] --> "apple"     (1番目の引数)
argv[2] --> "orange"    (2番目の引数)
argv[argc] は NULL ポインタ (C言語の決まりごと)

これで、`argc` で引数の個数を確認し、`argv` でそれぞれの引数の内容（文字列）を取り出す準備ができました！

C言語コマンドライン引数の基本的な使い方【サンプルコード】

さあ、いよいよ実践です！ `argc` と `argv` を使って、実際にコマンドライン引数を表示する簡単なプログラムを作ってみましょう。

百聞は一見にしかず、まずはコードを見て動かしてみるのが一番です！

サンプルプログラム：受け取った引数を表示する

以下のコードは、実行時に渡されたすべてのコマンドライン引数（プログラム名も含む）を順番に画面に出力するプログラムです。

#include <stdio.h>

// main関数で argc と argv を受け取る
int main(int argc, char *argv[]) {

  printf("受け取った引数の数 (argc): %d\n", argc);
  printf("受け取った引数の内容 (argv):\n");

  // argc の数だけループして、argv の中身を表示する
  // i = 0 はプログラム名なので、0から始める
  for (int i = 0; i < argc; i++) {
    printf("  argv[%d]: %s\n", i, argv[i]);
  }

  return 0; // プログラムの正常終了
}

とってもシンプルですよね。`main` 関数で `argc` と `argv` を受け取り、`for` ループを使って `argc` の回数だけ繰り返し処理をしています。

ループの中で `argv[i]` を `printf` で表示することで、各引数の文字列を出力しているわけです。

コンパイルと実行方法（引数を渡してみよう）

では、上のプログラムを動かしてみましょう！

1. 保存: 上のコードを `args_test.c` みたいな名前で保存します。

2. コンパイル: ターミナルで、保存したファイルがあるディレクトリに移動して、以下のコマンドを実行します。（gcc が入っている前提です）

gcc args_test.c -o args_test

これで `args_test` という名前の実行ファイルができます。

3. 実行！: いよいよ実行です。引数を変えながら、いくつか試してみましょう！

実行例1：引数なし

$ ./args_test
受け取った引数の数 (argc): 1
受け取った引数の内容 (argv):
  argv[0]: ./args_test

実行例2：引数を2つ渡す

$ ./args_test hello world
受け取った引数の数 (argc): 3
受け取った引数の内容 (argv):
  argv[0]: ./args_test
  argv[1]: hello
  argv[2]: world

実行例3：数字や記号を含む引数を渡す

$ ./args_test 123 data.txt -x
受け取った引数の数 (argc): 4
受け取った引数の内容 (argv):
  argv[0]: ./args_test
  argv[1]: 123
  argv[2]: data.txt
  argv[3]: -x

どうでしょうか？渡した引数の数や内容が、ちゃんとプログラムで受け取れて表示されましたね！ 実際に手を動かして試してみると、理解がぐっと深まりますよ。

応用例：コマンドライン引数を数値として使う

さて、先ほど `argv` の中身は全部「文字列」だと説明しました。でも、プログラムによっては引数で渡された数字を使って計算したい場合もありますよね。

例えば、引数で二つの数値を受け取って、その合計を表示するプログラムはどう書けばいいでしょう？
そのまま `argv[1]` と `argv[2]` を足そうとしても、文字列同士なのでうまく計算できません。

そこで登場するのが、文字列を数値に変換する関数です！標準ライブラリ（最初から用意されている便利な機能群）の中に、そういう関数があるんです。

`atoi()` : 文字列を 整数 (int) に変換します。
`atof()` : 文字列を 浮動小数点数 (double) に変換します。

これらの関数を使うには、プログラムの最初に `#include ` を書く必要があります。

では、引数で渡された二つの数値を足し算するサンプルコードを見てみましょう。

#include <stdio.h>
#include <stdlib.h> // atoi を使うために必要

int main(int argc, char *argv[]) {

  // 引数が足りない場合のエラーチェック（後で詳しく説明します）
  if (argc != 3) {
    printf("使い方: %s 数値1 数値2\n", argv[0]);
    return 1; // エラー終了
  }

  // argv[1] と argv[2] を整数に変換
  int num1 = atoi(argv[1]);
  int num2 = atoi(argv[2]);

  // 計算して結果を表示
  int sum = num1 + num2;
  printf("%d + %d = %d\n", num1, num2, sum);

  return 0;
}

このプログラムを `sum_test.c` として保存し、コンパイルして実行してみましょう。

$ gcc sum_test.c -o sum_test
$ ./sum_test 10 25
10 + 25 = 35

$ ./sum_test 5 -3
5 + -3 = 2

ちゃんと文字列として受け取った "10" や "25" を、`atoi()` を使って整数に変換し、計算できているのがわかりますね。これで、引数を数値として扱う方法もマスターです！

C言語コマンドライン引数を使う上での注意点

コマンドライン引数はとても便利ですが、使う上でいくつか気をつけておきたい点があります。これを怠ると、プログラムが予期せぬ動きをしたり、エラーで止まってしまったりする可能性があります。しっかり確認しておきましょう！

引数の数が期待通りかチェックする (`argc` の確認)

プログラムが特定の数の引数を期待している場合、ユーザーがそれより少ない数、あるいは多い数の引数を渡してくる可能性があります。

例えば、さっきの足し算プログラム `sum_test` は、2つの数値（つまり引数が合計で3つ、プログラム名含む）を期待しています。もしユーザーが `./sum_test 10` のように引数を1つしか渡さなかったらどうなるでしょう？

プログラムの中では `argv[2]` にアクセスしようとしますが、`argv[2]` は存在しません。これは配列の範囲外アクセスという、プログラムがクラッシュ（強制終了）する原因になる、とっても危険な操作です！

これを防ぐために、`argv` の要素にアクセスする前に、必ず `argc` をチェックして、期待する数の引数がちゃんと存在するかを確認する習慣をつけましょう。

#include <stdio.h>
#include <stdlib.h>

int main(int argc, char *argv[]) {

  // ★★★ ここで argc をチェック！ ★★★
  // プログラム名と、数値2つの、合計3つの引数が必要
  if (argc != 3) {
    // 引数の数が違う場合は、正しい使い方を表示して終了する
    fprintf(stderr, "エラー: 引数の数が正しくありません。\n");
    fprintf(stderr, "使い方: %s 数値1 数値2\n", argv[0]);
    return 1; // 異常終了を示すために 0 以外を返す
  }

  // ここに来るということは、argc は 3 なので、
  // 安全に argv[1] と argv[2] にアクセスできる
  int num1 = atoi(argv[1]);
  int num2 = atoi(argv[2]);
  int sum = num1 + num2;

  printf("%d + %d = %d\n", num1, num2, sum);

  return 0;
}

このように `if (argc != 期待する数)` のような形でチェックし、数が合わなければ使い方を示すメッセージを表示してプログラムを終了させるのが、親切で安全な作り方です。

`fprintf(stderr, ...)` は、標準エラー出力にメッセージを出すためのもので、エラーメッセージ表示によく使われます。

引数は必ず「文字列」として渡されることを忘れない

これは繰り返しになりますが、すごく大事なことなので、もう一度。
`argv` 配列に入っているのは、たとえ `123` や `3.14` のように見えても、すべて文字列 (`char *`) です。

ですから、数値として扱いたい場合は、

整数なら `atoi()`
浮動小数点数なら `atof()`

といった関数を使って、必ず数値型に変換する必要があります。この変換を忘れると、コンパイルエラーになったり、意図しない動作になったりします。

また、もしユーザーが数値として変換できない文字列（例えば "abc"）を引数として渡してきた場合、`atoi()` や `atof()` は通常 `0` や `0.0` を返します。

これも予期せぬ動作の原因になることがあるので、より本格的なプログラムでは、変換が成功したかどうかをチェックする、もう少し高度な方法（`strtol` や `strtod` など）を使うこともあります。…が、まずは「文字列だから変換が必要！」という点をしっかり覚えておきましょう！

【まとめ】C言語コマンドライン引数を活用してプログラムを便利に！

お疲れ様でした！今回はC言語のコマンドライン引数について、基本的なところから見てきました。

ポイントを振り返ってみましょう。

コマンドライン引数は、プログラム実行時に外から情報を与える仕組み。
`main` 関数の `int argc` で引数の個数（プログラム名含む）がわかる。
`main` 関数の `char *argv[]` で引数の内容（文字列の配列）を受け取れる。
`argv[0]` はプログラム名、`argv[1]` 以降が渡された引数。
引数はすべて文字列なので、数値として使うには `atoi()` や `atof()` で変換が必要。
`argv` にアクセスする前には `argc` をチェックして、安全なプログラムを心がけよう！

コマンドライン引数を使いこなせるようになると、C言語のプログラミングがもっと楽しく、そしてもっと実用的になります。ファイル処理やツールの作成など、作れるプログラムの幅がぐんと広がること間違いなしです。

最初はちょっと戸惑うかもしれませんが、今回紹介したサンプルコードなどを参考に、ぜひ皆さんのプログラムにもコマンドライン引数を取り入れてみてください。きっと、プログラムがより柔軟で使いやすくなるのを実感できるはずです！

【関連記事】

>> C言語とは？特徴・できること・学ぶメリット

C言語のコマンドライン引数とは？使い方を初心者向けに徹底解説