終了コード
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;チャレンジ
簡単コマンドラインツールのように、トラッカーでエラーが発生するようにしましょう。stderrにメッセージを出力し、終了コードを1にします。
Program.csの最後の行にreturn 0;を追加します。addケースの先頭で、args.Length < 3の場合、Console.Error.WriteLineでUsage: add <name> <amount>を出力し、return 1;を実行します。現在はdotnet run -- add Lunchを実行すると、args[2]が存在しないためクラッシュします。Console.Error.WriteLineでInvalid amount: abcを出力し、そのbreak;をreturn 1;に置き換えます。defaultケースでも同様にします。Unknown command: flyをstderrに出力し、プログラムは1を返します。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;
}
}
このレッスンには短いクイズがあります。レッスンを始めて解答し、進捗を記録しましょう。