• 0

كيف يُمكنني كتابة تعليقات مُتعدّدة الأسطر في روبي؟

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

انشر على الشّبكات الاجتماعية


رابط هذه المساهمة
  • 0

التّعليقات في البرمجة مهمّة جدّا، والحرص على شرح الشيفرات التّي تكتبها من صفات المُبرمجين ذوي الخبرة، فقط احرص على ألّا تُفرط في كتابة التّعليقات بحيث يصعب التّمييز بينها وبين الشيفرة ذاتها.
هناك العديد من الطّرق لكتابة التّعليقات في لغة روبي، أكثرها شيوعا كتابة التّعليق بعد علامة #:

#هذا تعليق مُتجاهل، لا يؤثّر على عمل البرنامج
puts 'Hello World!'

ويُمكنك تكرار العمليّة كلّما أردت أن تكتب المزيد من الأسطر:

#هذا تعليق مُتجاهل، لا يؤثّر على عمل البرنامج
#هذا تعليق مُتجاهل، لا يؤثّر على عمل البرنامج
#هذا تعليق مُتجاهل، لا يؤثّر على عمل البرنامج
puts 'Hello World!'

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

=begin
هذا النوع من التّعليقات خاص ببداية البرنامج

وسيعطي خطأ إذا حاولت وضعه في وسط الشّيفرة
=end

 

لكن لا تقلق يُمكنك أن تضع تعليقات وسط البرنامج دون أخطاء ودون الحاجة لكتابة العلامة # كلّ مرّة، وإليك الطّريقة الأكثر استعمالا:
 

<←DOC

هذا النّوع من التّعليقات لا يسبّب أي مشاكل 

ويُمكنك أن تكتبه في أكثر من سطر
DOC
puts "Hello world!"


 

هذه طريقة أخرى للتّعليق:

"
هذا النّوع من التّعليقات لا يسبّب أي مشاكل 

ويُمكنك أن تكتبه في أكثر من سطر

"
puts "Hello world!"

 

انشر على الشّبكات الاجتماعية


رابط هذه المساهمة

يجب أن تكون عضوًا لدينا لتتمكّن من التعليق

انشاء حساب جديد

يستغرق التسجيل بضع ثوان فقط


سجّل حسابًا جديدًا

تسجيل الدخول

تملك حسابا مسجّلا بالفعل؟


سجّل دخولك الآن