اذهب إلى المحتوى

السؤال

نشر

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

Recommended Posts

  • 0
نشر

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

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

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

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

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

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

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

 

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

<←DOC

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

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


 

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

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

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

"
puts "Hello world!"

 

انضم إلى النقاش

يمكنك أن تنشر الآن وتسجل لاحقًا. إذا كان لديك حساب، فسجل الدخول الآن لتنشر باسم حسابك.

زائر
أجب على هذا السؤال...

×   لقد أضفت محتوى بخط أو تنسيق مختلف.   Restore formatting

  Only 75 emoji are allowed.

×   Your link has been automatically embedded.   Display as a link instead

×   جرى استعادة المحتوى السابق..   امسح المحرر

×   You cannot paste images directly. Upload or insert images from URL.

  • إعلانات

  • تابعنا على



×
×
  • أضف...