أول خرج وقراءة التشخيص

ما ستتعلمه

ستغير تحية، وتتوقع خرجها الحرفي، وتستخدم موضعا مذكورا في رسالة تشخيص لإصلاح خطأ في المصدر. وستميز النص المطبوع عن حالة البرنامج.

قبل أن تبدأ

لا تحتاج إلى خبرة برمجية أو تثبيت. يشرح أول برنامج في المتصفح أدوات ساحة التجربة. المصدر هو نص برنامجك. يفحص التحقق ما إذا كان المصدر يتبع قواعد اللغة. يفحص زر التشغيل المصدر ثم ينفذ تعليماته إذا نجح التحقق.

يفتح كل مثال كامل أدناه مسودة جديدة في الصفحة الرئيسية بمصدره الأصلي. تبقى مسوداتك السابقة وتعديلاتك متاحة. يجري الفتح تحققا من المصدر لكنه لا يشغله. اضغط التشغيل بنفسك. لغة الشرح مستقلة عن مفردات المصدر. يتيح محدد المثال كلمات عربية وإنجليزية موردة، ولا يترجم التحية بين علامتي الاقتباس أو مسودتك.

اقرأ برنامجا كاملا

تحتاج لبات إلى دالة دخول محجوزة اسمها ابدأ_الرئيسية، أو مرادفها الإنجليزي المطابق start_main. يبدأ التنفيذ منها. تعلن دالة / fn عن دالة. تعني () الفارغة أن دالة الدخول لا تأخذ معاملات. وتعني -> ص64 / -> i64 أنها تعيد عددا صحيحا يمثل حالة الانتهاء. أبق هذا التوقيع كما ورد وأنت تتعلم التعليمات داخله.

يحدد القوسان المعقوفان بداية جسم الدالة ونهايته. تنفذ التعليمات داخله بالترتيب. تكتب اطبع / print سلسلة نصية، وهي نص بين علامتي اقتباس مزدوجتين. تمرر الأقواس تلك السلسلة إلى اطبع. لا تضيف اطبع نهاية سطر. يطلب المحرفان \س داخل السلسلة نهاية سطر واحدة، فيبدأ الخرج التالي في سطر جديد. تنتهي التعليمات الإنجليزية بـ ;، ويمكن أن تنتهي التعليمات العربية بـ .. لا تظهر علامة إنهاء التعليمة في الخرج.

تنهي أرجع 0 / return 0 دالة الدخول بصورة طبيعية بحالة عملية 0. لا تطبع الرقم صفر. سنستخدم هذه النهاية في كل درس مستقل. سنتعلم تعريف دوال أخرى لاحقا.

دالة ابدأ_الرئيسية() -> ص64 {
    اطبع("Hello\س").
    أرجع 0.
}

{
  "browser": {
    "check": "success",
    "class": "success",
    "output": "Hello\n",
    "processStatus": 0
  },
  "native": {
    "check": 0,
    "status": 0,
    "output": "Hello\n"
  }
}

بعد التشغيل، تحتوي منطقة الخرج على Hello ثم نهاية سطر واحدة، أي Hello\n عند تمثيل نهاية السطر بتسلسل الهروب. تعني Hello التحية بالإنجليزية، وتبقى كما كتبها المصدر حتى مع الكلمات العربية. تعرض منطقة الحالة انتهاء طبيعيا مع start_main 0. يتضمن المصدر علامات اقتباس وعلامة إنهاء تعليمة، ولا يتضمن الخرج أيا منها.

توقع قبل التشغيل

ما النص الحرفي الذي سيظهر؟ وهل ينتهي بنهاية سطر؟ هل سيظهر 0 في الخرج؟ اكتب توقعك ثم شغل المثال وقارن. ستجد سطرا واحدا هو Hello مع نهاية سطر بعده، دون طباعة صفر.

غير التحية

غير Hello فقط إلى Welcome داخل علامتي الاقتباس. أبق \س. السلوك المتوقع هو Welcome\n حرفيا، مع حالة طبيعية 0. اكتب توقعك قبل الضغط على التشغيل.

دالة ابدأ_الرئيسية() -> ص64 {
    اطبع("Welcome\س").
    أرجع 0.
}

{
  "browser": {
    "check": "success",
    "class": "success",
    "output": "Welcome\n",
    "processStatus": 0
  },
  "native": {
    "check": 0,
    "status": 0,
    "output": "Welcome\n"
  }
}

اتبع موضع خطأ المصدر

هذه نسخة برنامج كامل مكسورة عمدا. ينقصها القوس المعقوف الختامي. افتحها لتفحص نتيجة التحقق قبل محاولة تشغيلها.

دالة ابدأ_الرئيسية() -> ص64 {
    اطبع("Hello\س").
    أرجع 0.

{
  "browser": {
    "check": "source-error",
    "class": "source-error",
    "output": "",
    "reason": "expected-token"
  },
  "native": {
    "check": 1,
    "status": 1,
    "output": "",
    "reason": "expected-token"
  }
}

يبلغ التحقق عن خطأ مصدر سببه expected-token: توقع right-brace ووجد end-of-file. الموضع هو السطر 4 والعمود 1، بعد آخر تعليمة مباشرة. اختر الموضع المذكور في ساحة التجربة. قد تظهر العلامة عند نهاية المصدر لأن المحرف الناقص لا يملك نصا موجودا يمكن تظليله.

أضف القوس المعقوف الختامي في ذلك الموضع. يعرض المقطع المسمى أدناه المحرف المطلوب فقط، وليس برنامجا مستقلا.

مقطع توضيحي

}

البرنامج المصحح هو مثال التحية الأصلي. ينجح التحقق الآن، ثم تختار التشغيل للحصول على Hello\n وحالة 0. لا ينفذ المصدر المكسور أي تعليمة ولا ينتج تحية، رغم ظهور تعليمة الطباعة قبل القوس الناقص. يصف تشخيص المصدر مصدرا مرفوضا. يأتي الخرج من تعليمات منفذة. وتصف الحالة الطبيعية كيفية انتهاء التنفيذ. اقرأ المزيد عن التشخيص والنتائج.

تحقق من فهمك

يمكنك المتابعة عندما تستطيع شرح موضع بدء التنفيذ، وسبب كتابة نهاية السطر صراحة، ولماذا لا يطبع الصفر، وكيف أصلحت القوس الناقص. هذه أسئلة للتحقق الذاتي. لا تحفظ درجة أو تقدما ولا تقفل التنقل. انتقل إلى الارتباطات والحساب حين تختار.