عرض مصدر Bash/traps

==عام==
قد تجد حالات لا تريد فيها من يستخدم شيفراتك النصية أن يخرج قبل الوقت المحدد عن طريق اختصارات لوحة المفاتيح حين تحتاج إلى مدخلات مثلًا أو عند القيام بعملية تنظيف، ويمكن استخدام أمر <code>trap</code> ليلتقط إشارات لوحة المفاتيح تلك، ويمكن برمجته مسبقًا لينفِّذ قائمة أوامر عند التقاط تلك الإشارات.

قواعد أمر <code>trap</code> واضحة ومباشرة:<syntaxhighlight lang="bash">
trap [الإشارات] [الأوامر]
</syntaxhighlight>هذا يجعل أمر <code>trap</code> يلتقط الإشارات المُعطاة له، والتي قد تكون أسماء إشارات مع سابقة SIG أو بدونها، أو تكون أرقام إشارات. وإن كانت الإشارة <code>0</code> أو <code>EXIT</code> فإن الأوامر التي حُددت يتم تنفيذها عند إغلاق الصدفة، أما إن كانت إحدى الإشارات <code>DEBUG</code> فإن قائمة الأوامر تُنفَّذ بعد كل أمر بسيط.

وإذا حدِّدَت إشارة ما كـ <code>ERR</code> فإن الأوامر في تلك الحالة تُنفَّذ عند كل أمر بسيط يخرج بحالة غير صفرية. لاحظ أن تلك الأوامر لن تُنفَّذ إن أتت حالة الخروج غير الصفرية من جزء من عبارة <code>if</code> أو من الحلقة التكرارية <code>while</code> أو <code>until</code>، وكذلك لن تُنفَّذ الأوامر إن كان رمز حالة الخروج (exit code) لمعامِل منطقي مثل <code>&&</code> (AND) أو <code>||</code> (OR) قيمةً غير صفرية، أو عند استخدام معامِل مثل <code>!</code> حيث يكون خرج الأمر معكوسًا.

وخرج أمر <code>trap</code> نفسه هو <code>0</code> إلا في حالة وجود تفصيل غير صحيح لإشارة ما. ستجد الخيارات التي يأخذها أمر <code>trap</code> مفصلة في صفحات دليل <code>info</code>.

إليك الآن مثالًا بسيطًا يلتقط ctrl+c من المستخدم ثم يطبع رسالة، لن يحدث شيء إذا حاولت أن تقتل هذا البرنامج دون تحديد إشارة <code>KILL</code>:<syntaxhighlight lang="bash">
#!/bin/bash
# traptest.sh

trap "echo Booh!" SIGINT SIGTERM
echo "pid is $$"

while :			# "while true" يعطي هذا نفس نتيجة.
do
        sleep 60	# لا يفعل هذا النص أي شيء.
done
</syntaxhighlight>
==كيف تفسر الصدفةُ الأفخاخ==
حين تلتقط bash إشارة تم ضبط فخ لها أثناء انتظار انتهاء أمر ما، فلن يتم تنفيذ الفخ حتى ينتهي الأمر، إلا في حالة انتظار أمر عبر أمر <code>wait</code> المُضمَّن، فحينها يتسبب التقاط الإشارة في خروج أمر <code>wait</code> فورًا بحالة خروج أكبر من 128، مباشرة بعد تنفيذ الفخ المضبوط لتلك الإِشارة.
==المزيد من الأمثلة==
===اكتشاف استخدام متغيرٍ ما===
قد ترغب في أن تعطي متغيرًا ما خاصية <code>trace</code> أثناء تصحيح (debugging) شيفرة نصية طويلة، وتضع فخًا لرسائل <code>DEBUG</code> لهذا المتغير، وإن كنت تصرّح عن متغير باستخدام شيء مثل <code>VARIABLE='''value'''</code> فإن استبدال الأسطر التالية بإعلان المتغير يعطيك معلومات قيِّمة عما تفعله شيفرتُك:<syntaxhighlight lang="bash">
declare -t VARIABLE=value

trap "echo VARIABLE is being used here." DEBUG

# بقية الشيفرة النصية
</syntaxhighlight>
===حذف المهملات عند الخروج===
يعتمد أمر <code>whatis</code> على قاعدة بيانات تُبنى بانتظام باستخدام شيفرة <code>makewhatis.cron</code> مع cron:<syntaxhighlight lang="bash">
#!/bin/bash

LOCKFILE=/var/lock/makewhatis.lock

# السابق بنجاح makewhatis يجب أن يُنفَّذ ملف

[ -f $LOCKFILE ] && exit 0

# عند الخروج lockfile احذف.

trap "{ rm -f $LOCKFILE ; exit 255; }" EXIT

touch $LOCKFILE
makewhatis -u -w
exit 0
</syntaxhighlight>
==انظر أيضًا==
*[[Bash/introduction to if|مقدمة إلى if في Bash]].

*[[Bash/more advanced if usage|استخدامات if المتقدمة في Bash]].
==مصادر==
* <span> </span>[http://tldp.org/LDP/Bash-Beginners-Guide/html/sect_12_02.html دليل Bash للمبتدئين، صفحة الأفخاخ].
<noinclude>{{DISPLAYTITLE:الأفخاخ في Bash}}</noinclude>
[[تصنيف:Bash]]
[[تصنيف:Bash traps]]
[[تصنيف:Bash signals]]