C言語 EXIT_FAILURE と EXIT_SUCCESS の違い

C言語における EXIT_FAILURE の詳細解説

概要

• ヘッダファイル: stdlib.h
• 定義: #define EXIT_FAILURE 1
• 用途: プログラムの異常終了を報告
• 返値: 1

EXIT_FAILURE の使い方

exit() 関数の引数として EXIT_FAILURE を渡すことで、プログラムが異常終了したことをオペレーティングシステムに通知できます。

#include <stdlib.h>

int main() {
  // エラー処理...

  // エラーが発生した場合
  exit(EXIT_FAILURE);

  return 0; // 正常終了
}

上記コードでは、エラー処理 の後にエラーが発生した場合、exit(EXIT_FAILURE) を呼び出してプログラムを異常終了させます。

EXIT_FAILURE と EXIT_SUCCESS

EXIT_FAILURE と対になるマクロとして EXIT_SUCCESS が存在します。こちらはプログラムが正常終了したことを示すために使用されます。

#include <stdlib.h>

int main() {
  // 処理...

  return EXIT_SUCCESS; // 正常終了
}

上記コードでは、処理 が完了した後、EXIT_SUCCESS を返してプログラムを正常終了させます。

• EXIT_FAILURE はマクロなので、直接数値 1 を渡しても同じ意味になります。
• 多くの場合、EXIT_FAILURE はエラー処理の最後に使用されます。
• プログラムが異常終了した場合、オペレーティングシステムはシェルに終了コード 1 を返します。

EXIT_FAILURE は、C言語でプログラムの異常終了を報告するために使用されるマクロです。プログラムが正常終了した場合は EXIT_SUCCESS を使用します。

C言語における EXIT_FAILURE のサンプルコード

ファイルオープンエラー

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

int main() {
  FILE *fp;

  // ファイルを開こうとする
  fp = fopen("nonexistent_file.txt", "r");

  // ファイルオープンに失敗した場合
  if (fp == NULL) {
    perror("fopen() failed");
    exit(EXIT_FAILURE);
  }

  // ファイルオープン成功時の処理

  fclose(fp);

  return EXIT_SUCCESS;
}

メモリ確保エラー

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

int main() {
  int *ptr;

  // メモリを確保しようとする
  ptr = malloc(sizeof(int) * 1000000);

  // メモリ確保に失敗した場合
  if (ptr == NULL) {
    fprintf(stderr, "malloc() failed\n");
    exit(EXIT_FAILURE);
  }

  // メモリ確保成功時の処理

  free(ptr);

  return EXIT_SUCCESS;
}

計算エラー

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

int main() {
  int a = 10, b = 0;

  // 0で割ろうとする
  int c = a / b;

  // 0で割った場合
  if (c == 0) {
    fprintf(stderr, "Division by zero\n");
    exit(EXIT_FAILURE);
  }

  // 0で割らなかった場合

  return EXIT_SUCCESS;
}

シグナル処理

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

void signal_handler(int signum) {
  fprintf(stderr, "Caught signal %d\n", signum);
  exit(EXIT_FAILURE);
}

int main() {
  // SIGINT シグナルハンドラを設定
  signal(SIGINT, signal_handler);

  // 無限ループ
  while (1) {
    // 処理...
  }

  return EXIT_SUCCESS;
}

C言語でプログラムの異常終了を報告する他の方法

エラーコードを返す

main() 関数から非ゼロの値を返すことで、プログラムが異常終了したことを報告できます。

int main() {
  // エラー処理...

  // エラーが発生した場合
  return 1; // エラーコード

  return 0; // 正常終了
}

この方法は、EXIT_FAILURE よりも詳細なエラー情報をオペレーティングシステムに伝えることができます。

stderr にエラーメッセージを出力することで、プログラムが異常終了したことをユーザーに通知できます。

int main() {
  // エラー処理...

  // エラーが発生した場合
  fprintf(stderr, "エラーメッセージ\n");

  return 1; // エラーコード
}

この方法は、ユーザーに何が起こったのかを伝えるのに役立ちます。

アサートを使用して、プログラムの状態が期待通りであることを確認できます。アサートが失敗すると、プログラムは異常終了します。

#include <assert.h>

int main() {
  int x = 10;

  // アサートを使用して、x が 10 であることを確認
  assert(x == 10);

  // x が 10 以外の場合、プログラムは異常終了
  x = 20;

  return 0; // 正常終了
}

この方法は、プログラムのバグを見つけるのに役立ちます。

ログファイルを使用する

ログファイルにエラー情報を記録することで、プログラムが異常終了した原因を調査することができます。

#include <stdio.h>

int main() {
  // エラー処理...

  // エラーが発生した場合
  FILE *fp = fopen("error.log", "a");
  fprintf(fp, "エラーメッセージ\n");
  fclose(fp);

  return 1; // エラーコード
}

この方法は、プログラムがどのように実行されたかを追跡するのに役立ちます。

EXIT_FAILURE は、C言語でプログラムの異常終了を報告する最も簡単な方法です。しかし、他の方法も状況に応じて役立ちます。