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، لذا يعرض Run Usage: add <name> <amount> باللون الأحمر، لأنه أُرسل إلى stderr، بدلًا من حدوث عطل. أضف 12.50 إلى الوسيطات واضغط Run مرة أخرى: Added Lunch: 12.50. لا تعرض الطرفية رموز الخروج، لذا يتحقق Check منها: يجب أن ينتهي 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