Menu
CoddyTech

Códigos de salida

Parte de la sección Conceptos básicos de C# y .NET del Journey de ASP.NET Core de Coddy. Lección 5 de 20.

Cuando un programa termina, devuelve un código de salida a lo que lo inició: 0 significa que funcionó; cualquier otro valor significa que falló. Los scripts y los servidores de compilación leen ese número. Las instrucciones de nivel superior lo establecen con return. Una vez que un return devuelve un número, todas las rutas deben terminar con uno, por lo que la última línea pasa a ser return 0;. Sin él, el compilador informa del error CS0161.

Los errores se envían al segundo flujo de salida, stderr, con Console.Error.WriteLine. La salida normal permanece en stdout, así que quien guarde la salida en un archivo seguirá viendo los errores.

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

Desafío

Fácil

Haz que el rastreador falle como lo hacen las herramientas de línea de comandos: con un mensaje en stderr y el código de salida 1.

  1. Añade return 0; como última línea de Program.cs.
  2. Al inicio del caso add, cuando args.Length < 3, escribe Usage: add <name> <amount> con Console.Error.WriteLine y return 1;. Hoy, dotnet run -- add Lunch falla porque args[2] no existe.
  3. Escribe Invalid amount: abc con Console.Error.WriteLine y reemplaza su break; por return 1;.
  4. Haz lo mismo en el caso default: Unknown command: fly se envía a stderr y el programa devuelve 1.
  5. Added Lunch: 12.50 permanece en stdout, y esa ejecución termina con 0.

Pruébalo: la terminal junto al editor ya muestra dotnet run -- add Lunch, así que, al pulsar Ejecutar, aparece Usage: add <name> <amount> en rojo porque se envió a stderr, en lugar de producirse un fallo. Añade 12.50 a los argumentos y vuelve a pulsar Ejecutar: Added Lunch: 12.50. La terminal no muestra los códigos de salida, así que Comprobar los lee: add Lunch abc y fly deben terminar con 1, y add Lunch 12.50, con 0.

Pruébalo tú mismo

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 iconPonte a prueba

Esta lección incluye un breve cuestionario. Empieza la lección para responderlo y registrar tu progreso.

Todas las lecciones de Conceptos básicos de C# y .NET