رموز الخروج
جزء من قسم أساسيات 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;التحدي
سهلاجعل أداة تتبّع النفقات تفشل بالطريقة التي تفشل بها أدوات سطر الأوامر: رسالة على stderr ورمز خروج 1.
- أضف
return 0;كسطر أخير فيProgram.cs. - في بداية الحالة
add، عندما يكونargs.Length < 3، اكتبUsage: add <name> <amount>باستخدامConsole.Error.WriteLineثمreturn 1;. اليوم، يتعطلdotnet run -- add Lunchلأنargs[2]غير موجود. - اكتب
Invalid amount: abcباستخدامConsole.Error.WriteLine، واستبدلbreak;الخاص بها بـreturn 1;. - افعل الشيء نفسه في الحالة
default: تُرسلUnknown command: flyإلى stderr ويُرجع البرنامج1. - تبقى
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;
}
}
يتضمن هذا الدرس اختبارًا قصيرًا. ابدأ الدرس للإجابة عليه وتتبّع تقدمك.