Menu
CoddyTech

Коды завершения

Часть раздела Основы C# и .NET путешествия по ASP.NET Core на Coddy. Урок 5 из 20.

Когда программа завершается, она передаёт код завершения тому, кто её запустил: 0 означает, что всё прошло успешно, любое другое значение означает сбой. Скрипты и серверы сборки считывают это число. Инструкции верхнего уровня задают его с помощью return. Как только один return возвращает число, каждый путь должен заканчиваться таким оператором, поэтому последняя строка становится return 0;. Без него компилятор сообщает об ошибке CS0161.

Ошибки выводятся во второй поток вывода — 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. Добавь return 0; последней строкой в Program.cs.
  2. В начале случая add, если args.Length < 3, выведи Usage: add <name> <amount> с помощью Console.Error.WriteLine и выполни return 1;. Сейчас команда dotnet run -- add Lunch завершается с ошибкой, потому что args[2] не существует.
  3. Выведи Invalid amount: abc с помощью Console.Error.WriteLine и замени его break; на return 1;.
  4. Сделай то же самое в случае default: Unknown command: fly отправляется в stderr, а программа возвращает 1.
  5. Added Lunch: 12.50 остаётся в stdout, а выполнение этой команды завершается с кодом 0.

Попробуй: в терминале рядом с редактором уже введена команда dotnet run -- add Lunch, поэтому при нажатии «Запустить» сообщение Usage: add <name> <amount> появится красным цветом, так как оно было отправлено в stderr, а не произойдёт сбой. Добавь 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