1. 導入：なぜプログラムの「終了コード」が重要なのか
皆さんが普段使っているコマンドラインツール（CLIツール）で、処理が失敗したのに「正常終了」と判定されてしまったら困りますよね？例えば、スクリプトが失敗したことを検知してバックアップを停止させたい場合、プログラムが「どこで、どう失敗したか」をOSに伝える必要があります。ここで重要になるのが「ExitCode（終了コード）」です。適切に値を返すことで、他のプログラムやOSと賢く連携できるようになります。
2. 基礎知識：ExitCodeとは何か
ExitCodeとは、プログラムが終了する際にOSに対して渡す「整数の合図」のことです。
一般的に、以下のルールで運用されます。
・0（ExitSuccess）：処理が正常に完了したことを意味します。
・0以外（ExitFailureなど）：何らかのエラーが発生したことを意味します。
特にシェルスクリプトの世界では、この値をチェックして「次の処理へ進むか、中断するか」を決定します。関数型言語の文脈では、この終了処理を「副作用」として扱い、明示的にexitWith関数などを用いて制御します。
3. 実装：エラーを正しく伝えるための論理
プログラム内でエラーが発生したとき、単に処理を止めるのではなく、OSに対して「失敗しました」というシグナルを送りましょう。多くの言語では、終了コードを引数に取る関数が用意されています。例えば、引数なしで「失敗」を伝える関数を呼び出すか、具体的なエラー番号を指定して終了させます。これにより、呼び出し元（親プロセス）は、なぜ処理が中断されたのかを正確に把握できます。
4. サンプルプログラム
ここでは、Haskellのような関数型言語の考え方を取り入れた、シンプルなCLIツールの終了処理例を紹介します。
-- システムの終了処理を行うためのモジュールをインポート
import System.Exit
main :: IO ()
main = do
putStrLn "処理を開始します..."
-- ここでは例として、エラーが発生したと仮定します
let isError = True
if isError
then do
-- エラーが発生した場合は exitFailure を実行
-- これによりOSに対して 1 (失敗) というコードが返されます
putStrLn "エラーが発生しました。プログラムを終了します。"
exitFailure
else do
-- 正常終了の場合は exitSuccess を実行
-- これによりOSに対して 0 (正常) というコードが返されます
putStrLn "処理が正常に完了しました。"
exitSuccess
5. 応用・注意点：現場で役立つアドバイス
現場でCLIツールを設計する際、以下のポイントに注意してください。
・エラーコードの使い分け：単なる「失敗」だけでなく、権限エラーには「126」、ファイルが見つからない場合は「127」など、慣習的に使われる終了コードを調べると、より親切なツールになります。
・副作用の分離：関数型プログラミングでは、終了処理（exitWith）は副作用を伴うため、メインのロジックからできるだけ分離し、プログラムの末端（main関数の出口）で一元管理するのがバグを防ぐコツです。
・ログの出力：終了コードを返す前に、必ず標準エラー出力（stderr）にエラーの理由を出力してください。ユーザーが「なぜ失敗したか」を理解するために不可欠です。
コメント