Menu
CoddyTech

Códigos de saída

Parte da seção Fundamentos de C# e .NET do Journey de ASP.NET Core da Coddy. Lição 5 de 20.

Quando um programa termina, ele fornece um código de saída para aquilo que o iniciou: 0 significa que funcionou; qualquer outro valor significa que falhou. Scripts e servidores de compilação leem esse número. Instruções de nível superior o definem com return. Depois que um return fornece um número, todos os caminhos precisam terminar com um, então a última linha passa a ser return 0;. Sem isso, o compilador informa o erro CS0161.

Os erros vão para o segundo fluxo de saída, stderr, com Console.Error.WriteLine. A saída normal permanece em stdout, então alguém que salva a saída em um arquivo ainda consegue ver os erros.

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

Desafio

Fácil

Faça o rastreador falhar como as ferramentas de linha de comando: uma mensagem em stderr e código de saída 1.

  1. Adicione return 0; como última linha de Program.cs.
  2. No início do caso add, quando args.Length < 3, escreva Usage: add <name> <amount> com Console.Error.WriteLine e return 1;. Hoje, dotnet run -- add Lunch trava, porque args[2] não existe.
  3. Escreva Invalid amount: abc com Console.Error.WriteLine e substitua o break; por return 1;.
  4. Faça o mesmo no caso default: Unknown command: fly vai para stderr e o programa retorna 1.
  5. Added Lunch: 12.50 continua em stdout, e essa execução termina com 0.

Experimente: o terminal ao lado do editor já mostra dotnet run -- add Lunch, então, ao clicar em Executar, Usage: add <name> <amount> aparece em vermelho, porque foi enviado para stderr, em vez de ocorrer uma falha. Adicione 12.50 aos argumentos e clique em Executar novamente: Added Lunch: 12.50. O terminal não mostra os códigos de saída, então “Verificar” os lê: add Lunch abc e fly devem terminar com 1, e add Lunch 12.50 com 0.

Experimente você mesmo

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 iconTeste seus conhecimentos

Esta lição inclui um quiz rápido. Comece a lição para respondê-lo e acompanhar seu progresso.

Todas as lições de Fundamentos de C# e .NET