التعليقات

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

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

# هذا تعليق
echo "Hello!"  # هذا يطبع أيضًا Hello!

عند تشغيل ما سبق، لا يُطبع سوى Hello!: فالتعليقات غير مرئية تمامًا للصدفة.

لا يبدأ الرمز # تعليقًا إذا ورد داخل علامات الاقتباس أو في منتصف كلمة: تطبع echo "Issue #5" النص Issue #5.

استخدامات شائعة للتعليقات:

١. شرح ما يفعله الأمر:

# اطبع رسالة ترحيب
echo "Welcome to the terminal!"

2. تعطيل أمر مؤقتًا:

# echo "This line is disabled"
echo "This line will execute"

٣. سطر Shebang:

يُخبر تعليق خاص في أعلى نص برمجي للصدفة النظامَ بأي صدفة يستخدم:

#!/bin/bash
echo "This script runs with Bash"

يبدأ هذا السطر بـ #! (ويُسمّى سطر شِبانغ)، ويتبعه المسار إلى الصدفة. وهو دائمًا السطر الأول في البرنامج النصي.

4. تعليقات TODO: حدّد المهام المستقبلية:

# TODO: أضف معالجة الأخطاء هنا
echo "Processing files..."