عرض مصدر Bash/the shift built-in

<noinclude>{{DISPLAYTITLE:استخدام الأمر المُضمَّن Shift في Bash}}</noinclude>
== وظيفة أمر shift ==
هو أحد أوامر صدفة بورن التي تأتي مع صدفة Bash أيضًا، ويأخذ هذا الأمر وسيطًا (argument) واحدًا ويكون ذلك الوسيط رقمًا، وتُنقل المعامِلات الموضعية إلى اليسار بمقدار هذا الرقم "N"، أما المعامِلات التي تلي ذلك، من 1+N وما بعده إلى #$ فإن أسماءها تُغيَّر إلى أسماء متغيرات من 1$ إلى #$ +1 - N.

فمثلًا لنقل أن لديك أمرًا يأخذ عشرة وسائط، وN تساوي 4، إذًا 4$ تصبح 1$، و 5$ تصبح 2$ وهكذا إلى أن تصل إلى 10$ التي تصبح 7$. أما 1$ و 2$ و 3$ الأُوَل فنستغني عنها.

ولا تتغير المعامِلات الموضعية إن كانت N تساوي صفرًا أو أكبر من #$ ولا يكون للأمر أي تأثير (العدد الإجمالي للوسائط، انظر [[Bash/more advanced if usage|الاستخدامات المتقدمة لعبارة if الشرطية في Bash]])، أما إن لم تكن N موجودة فإن قيمتها تكون 1 افتراضيًا. كذلك تكون حالة الإعادة صفرًا ما لم تكن N أكبر من #$ أو أقل من صفر، وإلا فإنها تكون غير صفرية.

== أمثلة ==
تُستخدم عبارة <code>shift</code> في الغالب عند عدم معرفة عدد وسائط أمر ما مسبقًا، كأن يُسمح للمستخدمين بإدخال أي عدد يرغبون به من الوسائط. وتُعالَج الوسائط في تلك الحالات في حلقة <code>while</code> مع حالة اختبار لـ (( #$ )). وتتحقق هذه الحالة ما دام عدد الوسائط أكبر من الصفر، ويعالج الوسائط كل من متغيرُ 1$ وعبارةُ <code>shift</code> . كذلك يقل عدد الوسائط في كل مرة تُنفَّذ فيها <code>shift</code> إلى أن يصل العدد إلى صفر، عندئذٍ تخرج حلقة <code>while</code>.

يستخدم مثال <code>cleanup.sh</code> أدناه عبارة <code>shift</code> لتعالج كل ملف في القائمة التي أنشأها أمر <code>find</code>:<syntaxhighlight lang="bash">
#!/bin/bash

# يمسح هذا البرنامج الملفات التي لم تُفتح منذ 365 يوم

USAGE="Usage: $0 dir1 dir2 dir3 ... dirN"

if [ "$#" == "0" ]; then
	echo "$USAGE"
	exit 1
fi

while (( "$#" )); do

if [[ $(ls "$1") == "" ]]; then 
	echo "Empty directory, nothing to be done."
  else 
	find "$1" -type f -a -atime +365 -exec rm -i {} \;
fi

shift

done
</syntaxhighlight><blockquote>'''الفرق بين <code>exec-</code> و <code>xargs</code>'''</blockquote><blockquote>يمكننا استخدام السطر التالي مكان أمر <code>find</code> بالأعلى:</blockquote><syntaxhighlight lang="bash">
find options | xargs [أوامر_تُنفذ_على_الملفات_التي_سيعثر_عليها_أمر_find]
</syntaxhighlight><blockquote>يبني أمر <code>xargs</code> ويُنفذ أسطر أوامر من مُدخل قياسي (standard input)، وميزة ذلك أن سطر الأوامر يُملأ حتى أقصى حد يتحمله النظام، وعندئذ فقط تُستدعى الأوامر التي يجب تنفيذها. وفي المثال السابق فإن ذلك الأمر الذي يجب تنفيذه هو <code>rm</code>، وإن كانت هناك وسائط أخرى فيُستخدم سطر أوامر جديد حتى يكتمل أو حتى تنتهي الوسائط. أما أمر <code>find -exec</code> فإنه يستدعي الأمر الذي يجب تنفيذه على الملفات التي وُجدت في كل مرة يوجد فيها ملف. وبهذا ترى أن استخدام <code>xargs</code> يسرِّع برنامجك وأداء حاسوبك.</blockquote>انظر المثال التالي حيث عدّلنا البرنامج الذي استخدمناه في [[Bash/catching user input#.D9.85.D8.B3.D8.AA.D9.86.D8.AF.D8.A7.D8.AA Here|مستندات Here]] من صفحة [[Bash/catching user input|الحصول على مُدخلات المستخدم في Bash]] كي يقبل تثبيت عدة حزَم مرة واحدة:<syntaxhighlight lang="bash">
#!/bin/bash
if [ $# -lt 1 ]; then
        echo "Usage: $0 package(s)"
        exit 1
fi
while (($#)); do
	yum install "$1" << CONFIRM
y
CONFIRM
shift
done
</syntaxhighlight>

== انظر أيضًا ==
* [[Bash/displaying user messages|عرض رسائل المستخدم في Bash]].
* [[Bash/pattern matching using Bash features|مطابقة الأنماط باستخدام ميزات Bash]].

== مصادر ==
* <span> </span>[http://tldp.org/LDP/Bash-Beginners-Guide/html/sect_09_07.html دليل Bash للمبتدئين، صفحة أمر shift].
[[تصنيف:Bash Shift Statement]]
[[تصنيف:Bash]]
[[تصنيف:Bash Arguments]]
[[تصنيف:Bash Positional Parameters]]
[[تصنيف:Bash Advanced If Usage]]
[[تصنيف:Bash While Loop]]
[[تصنيف:Bash Writing Scripts]]