Menu
CoddyTech

終了コード

CoddyのASP.NET Coreジャーニー「C# と .NET の基礎」セクションの一部。レッスン 5/20。

プログラムが終了すると、起動元に終了コードを渡します。0は正常終了を意味し、それ以外は失敗を意味します。スクリプトやビルドサーバーはこの数値を読み取ります。トップレベルステートメントでは、returnを使って終了コードを設定します。1つのreturnで数値を返すと、すべての経路で終了コードを返す必要があるため、最後の行はreturn 0;になります。これがないと、コンパイラーはエラーCS0161を報告します。

エラーは2つ目の出力ストリームであるstderrに、Console.Error.WriteLineを使って出力します。通常の出力はstdoutに出力されるため、出力をファイルに保存した人もエラーを確認できます。

if (args.Length != 1)
{
    Console.Error.WriteLine("Usage: greet <name>");
    return 1;
}
Console.WriteLine($"Hello, {args[0]}!");
return 0;
challenge icon

チャレンジ

簡単

コマンドラインツールのように、トラッカーでエラーが発生するようにしましょう。stderrにメッセージを出力し、終了コードを1にします。

  1. Program.csの最後の行にreturn 0;を追加します。
  2. addケースの先頭で、args.Length < 3の場合、Console.Error.WriteLineでUsage: add <name> <amount>を出力し、return 1;を実行します。現在はdotnet run -- add Lunchを実行すると、args[2]が存在しないためクラッシュします。
  3. Console.Error.WriteLineでInvalid amount: abcを出力し、そのbreak;をreturn 1;に置き換えます。
  4. defaultケースでも同様にします。Unknown command: flyをstderrに出力し、プログラムは1を返します。
  5. Added Lunch: 12.50はstdoutに出力され、その実行は0で終了します。

試してみましょう:エディターの横にあるターミナルには、すでにdotnet run -- add Lunchと表示されています。「実行」を押すと、クラッシュする代わりに、stderrに出力されたことを示す赤い文字でUsage: add <name> <amount>が表示されます。引数に12.50を追加して、もう一度「実行」します。すると、Added Lunch: 12.50と表示されます。ターミナルには終了コードが表示されないため、「確認」で終了コードを読み取ります。add Lunch abcとflyは1で終了し、add Lunch 12.50は0で終了する必要があります。

自分で試してみよう

using System.Globalization;

var count = 0;
var total = 0m;

if (args.Length == 0)
{
    Console.WriteLine("Expense Tracker");
    Console.WriteLine($"{count} expenses");
    Console.WriteLine($"Total: {total:F2}");
}
else
{
    switch (args[0])
    {
        case "add":
            if (!decimal.TryParse(args[2], CultureInfo.InvariantCulture, out var amount))
            {
                Console.WriteLine($"Invalid amount: {args[2]}");
                break;
            }
            Console.WriteLine($"Added {args[1]}: {amount:F2}");
            break;
        default:
            Console.WriteLine($"Unknown command: {args[0]}");
            break;
    }
}
quiz icon腕試し

このレッスンには短いクイズがあります。レッスンを始めて解答し、進捗を記録しましょう。

C# と .NET の基礎のすべてのレッスン