Zig Academy · درس

كتابة المخرجات ورموز الخروج

أبلغ عن النتائج وأشر إلى الحالة

الدرس 3 من 413 خطوة

كتابة المخرجات ورموز الخروج درس مجاني في Zig Academy على CoddyKit. هذا هو الدرس 3 من أصل 4. يمكنك قراءة الدرس كاملاً أدناه مجاناً — ثم تمرن عليه مباشرة في المتصفح باستخدام محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7. هذا الدرس جزء من مسار التعلم في Zig Academy، وتقدمك يتزامن عبر الويب وتطبيق CoddyKit. تتضمن دورة Zig Academy 4 دروس في المجموع.

تردّ الأدوات عليك

قراءة الإدخال نصف المهمة. تكتب أداة CLI المكتملة أيضًا المخرجات وتُبلغ عن النجاح أو الفشل إلى الجهة التي شغّلتها. 📤

قناتا مخرجات

للبرامج قناتان: stdout للنتائج العادية وstderr للرسائل والأخطاء. يتيح إبقاؤهما منفصلتين للمستخدمين تمرير النتائج بوضوح.

احصل على كاتب stdout

استخدم std.io.getStdOut واطلب منه كاتبًا. هذا الكاتب هو المقبض الذي تستخدمه لإرسال المخرجات العادية إلى الطرفية.

const out = std.io.getStdOut().writer();

اطبع باستخدام print

تنسّق دالة print الخاصة بالكاتب البيانات وتكتبها في استدعاء واحد، باستخدام سلسلة التنسيق ومجموعة الوسائط اللتين تعرفهما بالفعل.

try out.print("Result: {d}\n", .{total});

قد تفشل الكتابة

تُرسل المخرجات إلى تدفق حقيقي قد يكون مغلقًا، لذلك تعيد عمليات الكتابة خطأً. ولهذا توضع try قبل كل print.

تذهب الأخطاء إلى stderr

أرسل التحذيرات وحالات الفشل إلى std.io.getStdErr حتى لا تفسد النتائج المُمرَّرة. يستطيع المستخدمون قراءة الأخطاء بينما تستمر البيانات في التدفق.

const err = std.io.getStdErr().writer();

مخرجات تصحيح سريعة

للتسجيل التقريبي، تكتب std.debug.print مباشرةً إلى stderr من دون الحاجة إلى try. وهي مفيدة أثناء التطوير، لا للمخرجات الفعلية.

std.debug.print("loaded {d} items\n", .{count});

قاعدة رموز الخروج

عند انتهاء البرنامج، يعيد رقمًا. يعني الصفر النجاح؛ بينما تخبر أي قيمة غير صفرية الصدفة بحدوث خطأ ما.

يمكن أن يعيد main أخطاءً

امنح main نوع إرجاع هو !void. إذا خرج خطأ إلى الخارج، يطبع Zig أثره وينهي البرنامج برمز غير صفري نيابةً عنك.

pub fn main() !void {}

اختر رمزك الخاص

هل تحتاج إلى حالة محددة؟ استدعِ std.process.exit مع قيمة u8. ينهي البرنامج فورًا باستخدام رمز الخروج المحدد تمامًا.

std.process.exit(2);

أفرغ المخزن قبل الخروج

إذا استخدمت buffered writer، فاستدعِ flush() قبل الخروج. وإلا فقد لا يصل النص المخزّن مؤقتًا إلى الطرفية مطلقًا.

try bw.flush();

تحقّق سريعًا

تذكّر ما الذي يخبر به رمز الخروج الصدفة التي شغّلت أداتك.

مراجعة

كتبت النتائج إلى stdout، والأخطاء إلى stderr، واستخدمت try في كل عملية كتابة، وأنهيت البرنامج برمز خروج واضح. أصبحت أداتك تُبلغ بوضوح. 🎯

البدء مجانًا

تعلم Zig مع معلم ذكاء اصطناعي — مجانًا

اكتب وقم بتشغيل أكوادك الفعلية في المتصفح، واحصل على مساعدة فورية من معلم ذكاء اصطناعي متاح 24/7، واستمر من حيث توقفت على الويب أو في التطبيق.

الدورات
30
الدروس
120

الأسئلة الشائعة

هل درس «كتابة المخرجات ورموز الخروج» مجاني؟

نعم — نص درس «كتابة المخرجات ورموز الخروج» كامل متاح مجاناً هنا على الويب. لتمرينه بشكل تفاعلي (محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7) وفتح باقي دورة Zig Academy، انتقل إلى CoddyKit PRO. تتضمن دورة Zig Academy 4 دروس في المجموع.

ماذا ستتعلم في «كتابة المخرجات ورموز الخروج»؟

أبلغ عن النتائج وأشر إلى الحالة تتمرن على Zig Academy مع أكواد عملية تشغلها مباشرة في المتصفح، ومدرس ذكاء اصطناعي متاح 24/7 يجيب على أسئلتك أثناء عملك.

هل أحتاج إلى خبرة سابقة لأبدأ Zig Academy؟

لا تُشترط خبرة سابقة. Zig Academy على CoddyKit منظم للمبتدئين حتى المتقدمين، لذا يمكنك البدء من هنا أو من البداية والتقدم بسرعتك الخاصة. هذا هو الدرس 3 من أصل 4.

كم من الوقت يستغرق درس «كتابة المخرجات ورموز الخروج»؟

معظم دروس CoddyKit تستغرق حوالي 5–10 دقائق. كل منها موجز وتفاعلي، لذا تحرز تقدماً مستمراً وتستأنف من حيث توقفت عبر الويب والتطبيق.

هل يمكنني كتابة وتشغيل أكواد في درس Zig Academy هذا؟

نعم. كل درس في Zig Academy يتضمن محرر أكواد مدمج، لذا تكتب وتشغل أكواداً حقيقية مباشرة في متصفحك وتحصل على تعليقات فورية من الذكاء الاصطناعي — بدون إعداد محلي.

جميع الدروس في هذه الدورة

  1. قراءة وسيطات سطر الأوامر
  2. قراءة الملفات وstdin
  3. كتابة المخرجات ورموز الخروج
  4. تغليف الملف التنفيذي وإصداره
← العودة إلى Zig Academy