الأوامر البسيطة¶

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

قيمة الإرجاع لـ أمر بسيط هي حالة خروجه، أو 128+n إذا أُنهي الأمر بواسطة الإشارة n.

الأنابيب (Pipelines)¶

الأنبوب هو تسلسل من أمر واحد أو أكثر يفصل بينها أحد عاملي التحكم | أو |&. تنسيق الأنبوب هو:

يُوصل الخرج القياسي لـ command1 عبر أنبوب بالدخل القياسي لـ command2. يُجرى هذا التوصيل قبل أي عمليات إعادة توجيه يحددها command1 (انظر إعادة التوجيه أدناه). إذا كان |& هو عامل الأنبوب، فإن خطأ command1 القياسي، بالإضافة إلى خرجه القياسي، يُوصل بالدخل القياسي لـ command2 عبر الأنبوب؛ وهو اختصار لـ 2>&1 |. تُجرى عملية إعادة التوجيه الضمنية هذه لخطأ القياسي إلى الخرج القياسي بعد أي عمليات إعادة توجيه يحددها command1.

حالة الإرجاع للأنبوب هي حالة خروج آخر أمر، ما لم يُفعل الخيار pipefail. إذا فُعل pipefail، فإن حالة إرجاع الأنبوب هي قيمة آخر أمر (في أقصى اليمين) يخرج بحالة غير صفرية، أو صفر إذا خرجت جميع الأوامر بنجاح. إذا سبقت الكلمة المحجوزة ! الأنبوب، تكون حالة خروج ذلك الأنبوب هي النفي المنطقي لحالة الخروج كما هو موضح أعلاه. إذا نُفذ الأنبوب بشكل متزامن، تنتظر الصدفة جميع الأوامر في الأنبوب لتنتهي قبل إرجاع القيمة.

إذا سبقت الكلمة المحجوزة time أنبوباً، تبلغ الصدفة عن الوقت المنقضي بالإضافة إلى وقت المستخدم والنظام المستهلك في تنفيذه عند انتهاء الأنبوب. يغير الخيار -p تنسيق الخرج إلى التنسيق الذي يحدده POSIX بدأت العلامة (token) التالية بـ “-”. قيمة المتغير TIMEFORMAT هي سلسلة تنسيق تحدد كيفية عرض معلومات التوقيت؛ انظر وصف TIMEFORMAT أدناه في قسم متغيرات الصدفة.

عندما تكون الصدفة في نمط posix، قد تظهر time بمفردها كالكلمة الوحيدة في أمر بسيط. في هذه الحالة، تعرض الصدفة إجمالي وقت المستخدم والنظام المستهلك بواسطة الصدفة وعملياتها التابعة. يحدد المتغير TIMEFORMAT تنسيق معلومات الوقت.

يُنفيذ كل أمر في أنبوب متعدد الأوامر، حيث تُنشأ الأنابيب، في صدفة فرعية، وهي عملية منفصلة. انظر بيئة تنفيذ الأوامر لوصف للصدف الفرعية وبيئتها. إذا فُعل الخيار lastpipe باستخدام أمر shopt المدمج (انظر وصف shopt أدناه)، ولم يكن التحكم في المهام نشطاً، فقد يُشغل العنصر الأخير من الأنبوب بواسطة عملية الصدفة نفسها.

قوائم¶

القائمة هي تسلسل من أنبوب واحد أو أكثر يفصل بينها أحد العوامل ;، أو &، أو &&، أو ||، وتنتهي اختيارياً بـ ;، أو &، أو <سطر_جديد>.

من بين عوامل القائمة هذه، يتمتع && و || بأولوية متساوية، يليهما ; و &، واللذان يتمتعان أيضاً بأولوية متساوية.

قد يظهر تسلسل من سطر جديد واحد أو أكثر في قائمة بدلاً من الفاصلة المنقوطة لترسيم الأوامر.

إذا أُنهي أمر بعامل التحكم &، تنفذ الصدفة الأمر في الخلفية في صدفة فرعية. لا تنتظر الصدفة انتهاء الأمر، وتكون حالة الإرجاع 0. يُشار إليها باسم الأوامر غير المتزامنة. تُنفذ الأوامر المفصولة بـ ; بشكل متسلسل؛ حيث تنتظر الصدفة انتهاء كل أمر بدوره. حالة الإرجاع هي حالة خروج آخر أمر نُفذ.

قوائم AND و OR هي تسلسلات من أنبوب واحد أو أكثر تفصل بينها عوامل التحكم && و || على التوالي. تُنفذ قوائم AND و OR بترابط من اليسار. تأخذ قائمة AND الشكل التالي

يُنفيذ command2 إذا، وفقط إذا، أرجع command1 حالة خروج صفرية (نجاح).

تأخذ قائمة OR الشكل التالي

يُنفيذ command2 إذا، وفقط إذا، أرجع command1 حالة خروج غير صفرية. حالة الإرجاع لقوائم AND و OR هي حالة خروج آخر أمر نُفذ في القائمة.

الأوامر المركبة¶

الأمر المركب هو أحد الأوامر التالية. في معظم الحالات، قد تُفصل قائمة في وصف الأمر عن بقية الأمر بسطر جديد واحد أو أكثر، وقد يتبعها سطر جديد بدلاً من الفاصلة المنقوطة.

(list)

تُنفيذ قائمة في صدفة فرعية (انظر بيئة تنفيذ الأوامر أدناه لوصف لبيئة الصدفة الفرعية). تعيينات المتغيرات والأوامر المدمجة التي تؤثر على بيئة الصدفة لا يظل مفعولها سارياً بعد اكتمال الأمر. حالة الإرجاع هي حالة خروج القائمة.

{ list; }

تُنفيذ قائمة في بيئة الصدفة الحالية. يجب إنهاء القائمة بسطر جديد أو فاصلة منقوطة. يُعرف هذا باسم أمر المجموعة. حالة الإرجاع هي حالة خروج القائمة.

لاحظ أنه على عكس المحارف الواصفة ( و )، فإن { و } هي كلمات محجوزة ويجب أن تظهر في مكان يُسمح فيه بالتعرف على الكلمات المحجوزة. وبما أنها لا تسبب فاصلاً بين الكلمات، يجب فصلها عن القائمة بمسافة فارغة أو محرف واصف آخر للصدفة.

((expression))

يُقيّم التعبير الحسابي وفقاً للقواعد الموضحة أدناه في قسم التقييم الحسابي. إذا كانت قيمة التعبير غير صفرية، تكون حالة الإرجاع 0؛ وخلاف ذلك تكون حالة الإرجاع 1. يخضع التعبير لنفس التوسعات كما لو كان داخل علامات اقتباس مزدوجة، لكن علامات الاقتباس المزدوجة غير المهربة في التعبير لا تُعامل معاملة خاصة وتُحذف. وبما أن هذا قد يؤدي إلى سلاسل فارغة، يعامل هذا الأمر تلك السلاسل كتعبيرات تُقيّم بـ 0.

[[ expression ]]

قيم التعبير الشرطي التعبير وأرجع حالة صفرية (صحيح) أو غير صفرية (خطأ). تتكون التعبيرات من العناصر الأساسية الموضحة أدناه في قسم التعبيرات الشرطية. الكلمات بين [[ و ]] لا تخضع لتقسيم الكلمات وتوسيع مسار الملف. تجري الصدفة توسيع علامة المدة، وتوسيع المعاملات والمتغيرات، والتوسيع الحسابي، واستبدال الأوامر، واستبدال العمليات، وحذف الاقتباس على تلك الكلمات. العوامل الشرطية مثل -f يجب أن تكون غير محاطة باقتباس ليُتعرف عليها كعناصر أساسية.

عند استخدامها مع [[، يقوم العاملان < و > بالفرز معجمياً باستخدام المحلية الحالية.

انظر وصف الأمر المدمج test (قسم SHELL BUILTIN COMMANDS أدناه) لمعرفة كيفية التعامل مع المعلمات (أي المعلمات المفقودة).

عند استخدام العاملين == و !=، تُعتبر السلسلة الموجودة على يمين العامل نمطاً وتتم مطابقتها وفقاً للقواعد الموضحة أدناه في قسم مطابقة الأنماط، كما لو كان خيار الصدفة extglob مفعلاً. العامل = يعادل ==. إذا فُعل خيار الصدفة nocasematch، تُجرى المطابقة دون مراعاة لحالة المحارف الأبجدية. قيمة الإرجاع هي 0 إذا طابقت السلسلة النمط (==) أو لم تطابقه (!=)، و 1 خلاف ذلك. إذا حُوصر أي جزء من النمط باقتباس، تتم مطابقة الجزء المقتبس كسلسلة نصية: كل محرف في الجزء المقتبس يطابق نفسه، بدلاً من أن يكون له أي معنى خاص لمطابقة الأنماط.

يتوفر عامل ثنائي إضافي، =~، بنفس أولوية == و !=. عند استخدامه، تُعتبر السلسلة الموجودة على يمين العامل تعبيراً نمطياً موسعاً POSIX وتتم مطابقتها وفقاً لذلك (باستخدام واجهات POSIX regcomp و regexec الموصوفة عادة في regex(3)). قيمة الإرجاع هي 0 إذا طابقت السلسلة النمط، و 1 خلاف ذلك. إذا كان التعبير النمطي غير صحيح لغوياً، تكون قيمة إرجاع التعبير الشرطي 2. إذا فُعل خيار الصدفة nocasematch، تُجرى المطابقة دون مراعاة لحالة المحارف الأبجدية.

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

تنجح المطابقة إذا طابق النمط أي جزء من السلسلة. ارسِ النمط باستخدام عاملي التعبير النمطي ^ و $ لإجباره على مطابقة السلسلة بأكملها.

يسجل متغير المصفوفة BASH_REMATCH أي أجزاء من السلسلة طابقت النمط. يحتوي العنصر ذو الفهرس 0 في BASH_REMATCH على جزء السلسلة الذي طابق التعبير النمطي بالكامل. تُحفظ السلاسل الفرعية التي طابقتها التعبيرات الفرعية المحاطة بأقواس داخل التعبير النمطي في فهارس BASH_REMATCH المتبقية. العنصر ذو الفهرس n في BASH_REMATCH هو جزء السلسلة الذي طابق التعبير الفرعي المحاط بأقواس رقم n. يضبط Bash المتغير BASH_REMATCH في النطاق العام؛ التصريح عنه كمتغير محلي سيؤدي إلى نتائج غير متوقعة.

يمكن دمج التعبيرات باستخدام العوامل التالية، مرتبة تنازلياً حسب الأولوية:

for name [ [ in word ... ] ; ] do list ; done

أولاً، يتم توسيع قائمة الكلمات التي تلي in، لإنتاج قائمة من العناصر. ثم، يُضبط المتغير name على كل عنصر من هذه القائمة بدوره، وتُنفيذ القائمة في كل مرة. إذا حُذفت in word، ينفذ أمر for القائمة مرة واحدة لكل معامل موضعي مضبوط (انظر المعاملات أدناه). حالة الإرجاع هي حالة خروج آخر أمر نُفذ. إذا أدى توسيع العناصر التي تلي in إلى قائمة فارغة، لا تُنفذ أي أوامر، وتكون حالة الإرجاع 0.

for (( expr1 ; expr2 ; expr3 )) [;] do list ; done

أولاً، يُقيم التعبير الحسابي expr1 وفقاً للقواعد الموضحة أدناه في قسم التقييم الحسابي. ثم، يُقيم التعبير الحسابي expr2 بشكل متكرر حتى يُقيم بـ صفر. في كل مرة يُقيم فيها expr2 بقيمة غير صفرية، تُنفذ القائمة ويُقيم التعبير الحسابي expr3. إذا حُذف أي تعبير، فإنه يتصرف كما لو كان يُقيم بـ 1. قيمة الإرجاع هي حالة خروج آخر أمر نُفذ في القائمة، أو قيمة غير صفرية إذا كان أي من التعبيرات غير صحيح.

استخدم أمري break و continue المدمجين (انظر أوامر الصدفة المدمجة أدناه) للتحكم في تنفيذ الحلقة.

select name [ in word ] ; do list ; done

أولاً، يتم توسيع قائمة الكلمات التي تلي in لإنتاج قائمة من العناصر، وتُطبع مجموعة الكلمات الموسعة على الخطأ القياسي، كل منها مسبوق برقم. إذا حُذفت in word، تُطبع المعاملات الموضعية (انظر المعاملات أدناه). ثم يعرض select المحث PS3 ويقرأ سطراً من الدخل القياسي. إذا كان السطر يتكون من رقم مطابق لإحدى الكلمات المعروضة، يضبط select قيمة name على تلك الكلمة. إذا كان السطر فارغاً، يعرض select الكلمات والمحث مرة أخرى. إذا قُرئت نهاية الملف (EOF)، يكتمل select ويعيد 1. أي قيمة أخرى تضبط name على قيمة فارغة. يُحفظ السطر المقروء في المتغير REPLY. تُنفذ القائمة بعد كل اختيار حتى يُنفذ أمر break. حالة خروج select هي حالة خروج آخر أمر نُفذ في القائمة، أو صفر إذا لم تُنفذ أي أوامر.

case word in [ [(] pattern [ | pattern ] ... ) list ;; ] ... esac

يقوم أمر case أولاً بتوسيع word، ويحاول مطابقتها مع كل pattern بدوره، بالانتقال من الأول إلى الأخير، باستخدام قواعد المطابقة الموضحة في قسم مطابقة الأنماط أدناه. قائمة الأنماط هي مجموعة من نمط واحد أو أكثر مفصولة بـ ، وينهي العامل ) قائمة الأنماط. يتم توسيع word باستخدام توسيع علامة المدة، وتوسيع المعاملات والمتغيرات، والتوسيع الحسابي، واستبدال الأوامر، واستبدال العمليات، وحذف الاقتباس. يتم توسيع كل pattern مفحوص باستخدام توسيع علامة المدة، وتوسيع المعاملات والمتغيرات، والتوسيع الحسابي، واستبدال الأوامر، واستبدال العمليات، وحذف الاقتباس. إذا فُعل خيار الصدفة nocasematch، تُجرى المطابقة دون مراعاة لحالة المحارف الأبجدية. البند (clause) هو قائمة أنماط و قائمة مرتبطة بها.

عند العثور على مطابقة، ينفذ case القائمة المقابلة. إذا أنهى العامل ;; بند case، يكتمل أمر case بعد المطابقة الأولى. يؤدي استخدام ;& بدلاً من ;; إلى استمرار التنفيذ مع القائمة المرتبطة بقائمة الأنماط التالية. ويؤدي استخدام ;;& بدلاً من ;; إلى قيام الصدفة باختبار قائمة الأنماط التالية في العبارة، إن وُجدت، وتنفيذ أي قائمة مرتبطة إذا نجحت المطابقة، مع الاستمرار في تنفيذ عبارة case كما لو أن قائمة الأنماط لم تتطابق. حالة الخروج هي صفر إذا لم يتطابق أي نمط.

خلاف ذلك، هي حالة خروج آخر أمر نُفذ في آخر قائمة نُفذت.

if list; then list; [ elif list; then list; ] ... [ else list; ] fi

تُنفيذ if list. إذا كانت حالة خروجها صفراً، تُنفذ then list. خلاف ذلك، تُنفذ كل elif list بدورها، وإذا كانت حالة خروجها صفراً، تُنفذ then list المقابلة ويكتمل الأمر. خلاف ذلك، تُنفذ else list، إن وُجدت. حالة الخروج هي حالة خروج آخر أمر نُفذ، أو صفر إذا لم يختبر أي شرط كصحيح.

while list-1; do list-2; done

until list-1; do list-2; done

ينفذ أمر while القائمة list-2 بشكل مستمر طالما أن آخر أمر في القائمة list-1 يعيد حالة خروج صفرية. أمر until مطابق لأمر while، إلا أن الاختبار منفي: تُنفذ list-2 طالما أن آخر أمر في list-1 يعيد حالة خروج غير صفرية. حالة الخروج لأمري while و until هي حالة خروج آخر أمر نُفذ في list-2، أو صفر إذا لم يُنفذ أي منها.

العمليات الرديفة (Coprocesses)¶

العملية الرديفة هي أمر صدفة تسبقه الكلمة المحجوزة coproc. تُنفذ العملية الرديفة بشكل غير متزامن في صدفة فرعية، كما لو أن الأمر قد أُنهي بعامل التحكم &، مع إنشاء أنبوب ثنائي الاتجاه بين الصدفة المنفذة والعملية الرديفة.

بناء الجملة للعملية الرديفة هو:

ينشئ هذا عملية مشتركة تُسمى الاسم. قد يكون الأمر إما أمراً بسيطاً أو أمراً مركباً (انظر أعلاه). الاسم هو اسم متغير صدفة. إذا لم يُزود الاسم، فإن الاسم المبدئي هو COPROC.

الصيغة الموصى بها للاستخدام مع العملية المشتركة هي

هذه الصيغة مفضلة لأن الأوامر البسيطة تؤدي دائماً إلى تسمية العملية المشتركة باسم COPROC، كما أنها أسهل في الاستخدام وأكثر اكتمالاً من الأوامر المركبة الأخرى.

إذا كان الأمر أمراً مركباً، يكون الاسم اختيارياً. تحدد الكلمة التي تلي coproc ما إذا كانت تلك الكلمة ستُفسر كاسم متغير: تُفسر على أنها الاسم إذا لم تكن كلمة محجوزة تقدم أمراً مركباً. إذا كان الأمر أمراً بسيطاً، فلا يُسمح بوجود الاسم؛ وذلك لتجنب الالتباس بين الاسم والكلمة الأولى من الأمر البسيط.

عند تنفيذ العملية المشتركة، تنشئ الصدفة متغيراً مصفوفاً (انظر المصفوفات أدناه) يُسمى الاسم في سياق الصدفة المنفذة. يُربط المخرج القياسي لـ الأمر عبر أنبوب بواصف ملف في الصدفة المنفذة، ويُعين واصف الملف هذا إلى الاسم[0]. ويُربط المدخل القياسي لـ الأمر عبر أنبوب بواصف ملف في الصدفة المنفذة، ويُعين واصف الملف هذا إلى الاسم[1]. يُنشأ هذا الأنبوب قبل أي عمليات إعادة توجيه يحددها الأمر (انظر إعادة_التوجيه أدناه). يمكن استخدام واصفات الملفات كوسائط لأوامر الصدفة وعمليات إعادة التوجيه باستخدام توسعات الكلمات القياسية. وباستثناء تلك التي أُنشئت لتنفيذ استبدال الأوامر والعمليات، لا تتوفر واصفات الملفات في الصدفات الفرعية.

يتوفر معرف العملية للصدفة التي أُطلقت لتنفيذ العملية المشتركة كقيمة للمتغير الاسم_PID. يمكن استخدام الأمر المدمج wait لانتظار انتهاء العملية المشتركة.

بما أن العملية المشتركة تُنشأ كأمر غير متزامن، فإن الأمر coproc يعود دائماً بالنجاح. حالة العودة للعملية المشتركة هي حالة الخروج لـ الأمر.

تعريفات وظائف الصدفة¶

وظيفة الصدفة هي كائن يُستدعى مثل أمر بسيط وينفذ أمراً مركباً مع مجموعة جديدة من المعاملات الموضعية. تُصرح وظائف الصدفة على النحو التالي:

اسم_الوظيفة () أمر-مركب [إعادة-توجيه]

function اسم_الوظيفة [()] أمر-مركب [إعادة-توجيه]

يُعرف هذا وظيفة تُسمى اسم_الوظيفة. الكلمة المحجوزة function اختيارية. إذا زُودت الكلمة المحجوزة function، تصبح الأقواس اختيارية. متن الوظيفة هو الأمر المركب أمر-مركب (انظر الأوامر المركبة أعلاه). هذا الأمر عادة ما يكون قائمة من الأوامر بين { و }، ولكن يمكن أن يكون أي أمر مدرج تحت الأوامر المركبة أعلاه. إذا استُخدمت الكلمة المحجوزة function ولم تُزود الأقواس، فيوصى باستخدام الأقواس المعقوفة. يُنفذ أمر-مركب كلما حُدد اسم_الوظيفة كاسم لأمر بسيط. عند التواجد في وضع posix، يجب أن يكون اسم_الوظيفة اسماً صالحاً للصدفة وألا يكون اسم أحد الأوامر المدمجة الخاصة لـ POSIX يمكن أن يكون اسم الوظيفة أي كلمة صدفة غير مقتبسة لا تحتوي على $.

أي عمليات إعادة توجيه (انظر إعادة_التوجيه أدناه) تُحدد عند تعريف الوظيفة تُنفذ عند تنفيذ الوظيفة.

حالة الخروج لتعريف الوظيفة هي صفر ما لم يحدث خطأ في بناء الجملة أو كانت هناك وظيفة للقراءة فقط بنفس الاسم موجودة بالفعل. عند التنفيذ، تكون حالة الخروج للوظيفة هي حالة الخروج لآخر أمر نُفذ في المتن. (انظر الوظائف أدناه.)

ترجمة السلاسل¶

تؤدي السلسلة المقتبسة اقتباساً مزدوجاً والمسبوقة بعلامة دولار ($"سلسلة") إلى ترجمة السلسلة وفقاً للمحلية الحالية. تقوم البنية التحتية لـ gettext بعملية البحث والترجمة، باستخدام متغيرات الصدفة LC_MESSAGES و TEXTDOMAINDIR و TEXTDOMAIN. إذا كانت المحلية الحالية هي C أو POSIX، أو إذا لم تكن هناك ترجمات متاحة، أو إذا لم تُترجم السلسلة، تُتجاهل علامة الدولار، وتُعامل السلسلة على أنها مقتبسة اقتباساً مزدوجاً كما هو موضح أعلاه. هذا شكل من أشكال الاقتباس المزدوج، لذا تظل السلسلة مقتبسة اقتباساً مزدوجاً مبدئياً، سواء تُرجمت واستُبدلت أم لا. إذا تم تمكين خيار noexpand_translation باستخدام الأمر المدمج shopt، فإن السلاسل المترجمة تُقتبس اقتباساً مفرداً بدلاً من الاقتباس المزدوج. انظر وصف shopt أدناه تحت أوامر الصدفة المدمجة.

المعاملات الموضعية¶

المعامل الموضعي هو معامل يُشار إليه برقم واحد أو أكثر، بخلاف الرقم المنفرد 0. تُعين المعاملات الموضعية من وسائط الصدفة عند استدعائها، وقد يُعاد تعيينها باستخدام الأمر المدمج set. لا يجوز التعيين للمعاملات الموضعية باستخدام جمل التعيين. تُستبدل المعاملات الموضعية مؤقتاً عند تنفيذ وظيفة صدفة (انظر الوظائف أدناه).

عند توسيع معامل موضعي يتكون من أكثر من رقم واحد، يجب إحاطته بأقواس معقوفة (انظر التوسيع أدناه). بدون الأقواس، لا يمكن للرقم الذي يلي $ إلا أن يشير إلى أحد المعاملات الموضعية التسعة الأولى ($1-$9) أو المعامل الخاص $0 (انظر القسم التالي).

المعاملات الخاصة¶

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

*

($*) يتوسع إلى المعاملات الموضعية، بدءاً من واحد. عندما لا يكون التوسيع داخل علامات اقتباس مزدوجة، يتوسع كل معامل موضعي إلى كلمة منفصلة. في السياقات التي تُجرى فيها توسعات الكلمات، تخضع تلك الكلمات لمزيد من تقسيم الكلمات وتوسيع مسار الملف. عندما يحدث التوسيع داخل علامات اقتباس مزدوجة، فإنه يتوسع إلى كلمة واحدة مع فصل قيمة كل معامل بواسطة الحرف الأول من متغير IFS. أي أن "$*" يعادل "$1c$2c..."، حيث c هو الحرف الأول من قيمة متغير IFS. إذا لم يُعين IFS، تُفصل المعاملات بمسافات. إذا كان IFS فارغاً، تُدمج المعاملات بدون فواصل بينها.

@

($@) يتوسع إلى المعاملات الموضعية، بدءاً من واحد. في السياقات التي يُجرى فيها تقسيم الكلمات، يوسع هذا كل معامل موضعي إلى كلمة منفصلة؛ وإذا لم يكن داخل علامات اقتباس مزدوجة، تخضع هذه الكلمات لتقسيم الكلمات. في السياقات التي لا يُجرى فيها تقسيم الكلمات، مثل جزء القيمة في جملة التعيين، يتوسع هذا إلى كلمة واحدة مع فصل كل معامل موضعي بمسافة. عندما يحدث التوسيع داخل علامات اقتباس مزدوجة، ويُجرى تقسيم الكلمات، يتوسع كل معامل إلى كلمة منفصلة. أي أن "$@" يعادل "$1" "$2" ... إذا حدث التوسيع المقتبس اقتباساً مزدوجاً داخل كلمة، يُدمج توسيع المعامل الأول مع توسيع الجزء الأول من الكلمة الأصلية، ويُدمج توسيع المعامل الأخير مع توسيع الجزء الأخير من الكلمة الأصلية. عندما لا توجد معاملات موضعية، يتوسع "$@" و $@ إلى لا شيء (أي يُزالان).

#

($#) يتوسع إلى عدد المعاملات الموضعية بالنظام العشري.

?

($?) يتوسع إلى حالة الخروج لآخر أمر نُفذ.

-

($-) يتوسع إلى أعلام الخيارات الحالية كما هي محددة عند الاستدعاء، أو بواسطة الأمر المدمج set، أو تلك التي عينتها الصدفة نفسها (مثل الخيار -i).

$

($$) يتوسع إلى معرف العملية للصدفة. في الصدفة الفرعية، يتوسع إلى معرف العملية للصدفة الأب، وليس للصدفة الفرعية.

!

($!) يتوسع إلى معرف العملية لآخر مهمة وُضعت في الخلفية، سواء نُفذت كأمر غير متزامن أو باستخدام الأمر المدمج bg (انظر التحكم في المهام أدناه).

0

($0) يتوسع إلى اسم الصدفة أو سكربت الصدفة. يُعين هذا عند تهيئة الصدفة. إذا استُدعي bash مع ملف من الأوامر، يُعين $0 باسم ذلك الملف. إذا بُدئ bash بالخيار -c، فسيُعين $0 بأول وسيط بعد السلسلة المراد تنفيذها، في حال وجوده. بخلاف ذلك، يُعين باسم الملف المستخدم لاستدعاء bash، كما هو معطى في الوسيط صفر.

متغيرات الصدفة¶

تعين الصدفة المتغيرات التالية:

_

($_، شرطة سفلية) لها عدة معانٍ حسب السياق. عند بدء تشغيل الصدفة، يُعين _ بمسار الملف المستخدم لاستدعاء الصدفة أو سكربت الصدفة الذي يجري تنفيذه كما هو ممرر في البيئة أو قائمة الوسائط. لاحقاً، يتوسع إلى آخر وسيط للأمر البسيط السابق الذي نُفذ في الواجهة، بعد التوسيع. كما يُعين أيضاً بالمسار الكامل المستخدم لاستدعاء كل أمر مُنفذ ويُوضع في البيئة المصدرة لذلك الأمر. عند التحقق من البريد، يتوسع $_ إلى اسم ملف البريد الذي يجري التحقق منه حالياً.

BASH

يتوسع إلى اسم الملف الكامل المستخدم لاستدعاء نسخة bash هذه.

BASHOPTS

قائمة مفصولة بنقطتين لخيارات الصدفة الممكنة. كل كلمة في القائمة هي وسيط صالح للخيار -s للأمر المدمج shopt (انظر أوامر الصدفة المدمجة أدناه). الخيارات التي تظهر في BASHOPTS هي تلك التي يبلغ shopt أنها تعمل. إذا كان هذا المتغير موجوداً في البيئة عند بدء تشغيل bash، ستمكن الصدفة كل خيار في القائمة قبل قراءة أي ملفات بدء تشغيل. إذا صُدر هذا المتغير، ستمكن الصدفات الابنة كل خيار في القائمة. هذا المتغير للقراءة فقط.

BASHPID

يتوسع إلى معرف العملية لعملية bash الحالية. يختلف هذا عن $$ في ظروف معينة، مثل الصدفات الفرعية التي لا تتطلب إعادة تهيئة bash. لا تأثير لعمليات التعيين لـ BASHPID. إذا أُلغي تعيين BASHPID، فإنه يفقد خصائصه الخاصة، حتى لو أُعيد تعيينه لاحقاً.

BASH_ALIASES

متغير مصفوفة ترابطية تتوافق عناصرها مع القائمة الداخلية للأسماء المستعارة كما يحافظ عليها الأمر المدمج alias. تظهر العناصر المضافة إلى هذه المصفوفة في قائمة الأسماء المستعارة؛ ومع ذلك، فإن إلغاء تعيين عناصر المصفوفة حالياً لا يزيل الأسماء المستعارة من قائمة الأسماء المستعارة. إذا أُلغي تعيين BASH_ALIASES، فإنه يفقد خصائصه الخاصة، حتى لو أُعيد تعيينه لاحقاً.

BASH_ARGC

متغير مصفوفة قيمها هي عدد المعاملات في كل إطار من مكدس استدعاءات تنفيذ bash الحالي. يكون عدد المعاملات للروتين الفرعي الحالي (وظيفة صدفة أو سكربت مُنفذ بـ . أو source) في قمة المكدس. عند تنفيذ روتين فرعي، يُدفع عدد المعاملات الممررة إلى BASH_ARGC. تعين الصدفة BASH_ARGC فقط عندما تكون في وضع التنقيح الموسع (انظر وصف خيار extdebug للأمر المدمج shopt أدناه). قد يؤدي تعيين extdebug بعد أن تبدأ الصدفة في تنفيذ سكربت، أو الإشارة إلى هذا المتغير عندما لا يكون extdebug معيناً، إلى قيم غير متسقة. لا تأثير لعمليات التعيين لـ BASH_ARGC، ولا يجوز إلغاء تعيينه.

BASH_ARGV

متغير مصفوفة يحتوي على جميع المعاملات في مكدس استدعاءات تنفيذ bash الحالي. المعامل النهائي لآخر استدعاء روتين فرعي يكون في قمة المكدس؛ والمعامل الأول للاستدعاء الأولي يكون في القاع. عند تنفيذ روتين فرعي، تدفع الصدفة المعاملات المزودة إلى BASH_ARGV. تعين الصدفة BASH_ARGV فقط عندما تكون في وضع التنقيح الموسع (انظر وصف خيار extdebug للأمر المدمج shopt أدناه). قد يؤدي تعيين extdebug بعد أن تبدأ الصدفة في تنفيذ سكربت، أو الإشارة إلى هذا المتغير عندما لا يكون extdebug معيناً، إلى قيم غير متسقة. لا تأثير لعمليات التعيين لـ BASH_ARGV، ولا يجوز إلغاء تعيينه.

BASH_ARGV0

عند الإشارة إليه، يتوسع هذا المتغير إلى اسم الصدفة أو سكربت الصدفة (مطابق لـ $0؛ انظر وصف المعامل الخاص 0 أعلاه). تعيين قيمة لـ BASH_ARGV0 يعين $0 لنفس القيمة. إذا أُلغي تعيين BASH_ARGV0، فإنه يفقد خصائصه الخاصة، حتى لو أُعيد تعيينه لاحقاً.

BASH_CMDS

متغير مصفوفة ترابطية تتوافق عناصرها مع جدول التلبيد (hash) الداخلي للأوامر كما يحافظ عليه الأمر المدمج hash. تؤدي إضافة عناصر إلى هذه المصفوفة إلى ظهورها في جدول التلبيد؛ ومع ذلك، فإن إلغاء تعيين عناصر المصفوفة حالياً لا يزيل أسماء الأوامر من جدول التلبيد. إذا أُلغي تعيين BASH_CMDS، فإنه يفقد خصائصه الخاصة، حتى لو أُعيد تعيينه لاحقاً.

BASH_COMMAND

يتوسع إلى الأمر الذي يجري تنفيذه حالياً أو على وشك التنفيذ، ما لم تكن الصدفة تنفذ أمراً نتيجة لفخ (trap)، وفي هذه الحالة يكون هو الأمر الذي كان يُنفذ وقت الفخ. إذا أُلغي تعيين BASH_COMMAND، فإنه يفقد خصائصه الخاصة، حتى لو أُعيد تعيينه لاحقاً.

BASH_EXECUTION_STRING

وسيط الأمر لخيار الاستدعاء -c.

BASH_LINENO

متغير مصفوفة عناصره هي أرقام الأسطر في ملفات المصدر حيث تم استدعاء كل عنصر مقابل من FUNCNAME. ${BASH_LINENO[$i]} هو رقم السطر في ملف المصدر (${BASH_SOURCE[$i+1]}) حيث استُدعيت ${FUNCNAME[$i]} (أو ${BASH_LINENO[$i-1]} إذا تمت الإشارة إليها داخل وظيفة صدفة أخرى). استخدم LINENO للحصول على رقم السطر الحالي. لا تأثير لعمليات التعيين لـ BASH_LINENO، ولا يجوز إلغاء تعيينه.

BASH_LOADABLES_PATH

قائمة مفصولة بنقطتين للأدلة التي يبحث فيها الأمر enable عن الأوامر المدمجة القابلة للتحميل ديناميكياً.

BASH_MONOSECONDS

في كل مرة يُشار فيها إلى هذا المتغير، فإنه يتوسع إلى القيمة التي تعيدها الساعة الرتيبة (monotonic clock) للنظام، إن وجدت. إذا لم تكن هناك ساعة رتيبة، فإن هذا يعادل EPOCHSECONDS. إذا أُلغي تعيين BASH_MONOSECONDS، فإنه يفقد خصائصه الخاصة، حتى لو أُعيد تعيينه لاحقاً.

BASH_REMATCH

متغير مصفوفة تُعين عناصرها بواسطة المعامل الثنائي =~ للأمر الشرطي [[. العنصر ذو الفهرس 0 هو جزء السلسلة الذي يطابق التعبير النمطي بأكمله. العنصر ذو الفهرس n هو جزء السلسلة الذي يطابق التعبير الفرعي المحصور بين أقواس ذي الرقم n.

BASH_SOURCE

متغير مصفوفة عناصره هي أسماء ملفات المصدر حيث عُرفت أسماء وظائف الصدفة المقابلة في متغير مصفوفة FUNCNAME. وظيفة الصدفة ${FUNCNAME[$i]} مُعرفة في الملف ${BASH_SOURCE[$i]} واستُدعيت من ${BASH_SOURCE[$i+1]}. لا تأثير لعمليات التعيين لـ BASH_SOURCE، ولا يجوز إلغاء تعيينه.

BASH_SUBSHELL

يزداد بمقدار واحد داخل كل صدفة فرعية أو بيئة صدفة فرعية عندما تبدأ الصدفة في التنفيذ في تلك البيئة. القيمة الأولية هي 0. إذا أُلغي تعيين BASH_SUBSHELL، فإنه يفقد خصائصه الخاصة، حتى لو أُعيد تعيينه لاحقاً.

BASH_TRAPSIG

يُعين برقم الإشارة المقابل لإجراء الفخ (trap) الذي يجري تنفيذه أثناء تنفيذه. انظر وصف trap تحت أوامر الصدفة المدمجة أدناه للحصول على معلومات حول أرقام الإشارات وتنفيذ الفخ.

BASH_VERSINFO

متغير مصفوفة للقراءة فقط تحمل عناصره معلومات الإصدار لنسخة bash هذه. القيم المعينة لعناصر المصفوفة هي كما يلي:

BASH_VERSION

يتوسع إلى سلسلة تصف إصدار نسخة bash هذه (مثلاً، 5.2.37(3)-release).

COMP_CWORD

فهرس داخل ${COMP_WORDS} للكلمة التي تحتوي على موضع المؤشر الحالي. يتوفر هذا المتغير فقط في وظائف الصدفة المستدعاة بواسطة تسهيلات الإكمال القابلة للبرمجة (انظر الإكمال القابل للبرمجة أدناه).

COMP_KEY

المفتاح (أو المفتاح النهائي في تسلسل مفاتيح) المستخدم لاستدعاء وظيفة الإكمال الحالية. يتوفر هذا المتغير فقط في وظائف الصدفة والأوامر الخارجية المستدعاة بواسطة تسهيلات الإكمال القابلة للبرمجة (انظر الإكمال القابل للبرمجة أدناه).

COMP_LINE

سطر الأوامر الحالي. يتوفر هذا المتغير فقط في وظائف الصدفة والأوامر الخارجية المستدعاة بواسطة تسهيلات الإكمال القابلة للبرمجة (انظر الإكمال القابل للبرمجة أدناه).

COMP_POINT

فهرس موضع المؤشر الحالي بالنسبة لبداية الأمر الحالي. إذا كان موضع المؤشر الحالي في نهاية الأمر الحالي، فإن قيمة هذا المتغير تساوي ${#COMP_LINE}. يتوفر هذا المتغير فقط في وظائف الصدفة والأوامر الخارجية المستدعاة بواسطة تسهيلات الإكمال القابلة للبرمجة (انظر الإكمال القابل للبرمجة أدناه).

COMP_TYPE

يُعين بقيمة عددية تتوافق مع نوع محاولة الإكمال التي تسببت في استدعاء وظيفة إكمال: TAB، للإكمال العادي، أو ?، لسرد الإكمالات بعد ضغطات تاب متتالية، أو !، لسرد البدائل عند إكمال كلمة جزئية، أو @، لسرد الإكمالات إذا لم تكن الكلمة غير معدلة، أو %، لإكمال القائمة. يتوفر هذا المتغير فقط في وظائف الصدفة والأوامر الخارجية المستدعاة بواسطة تسهيلات الإكمال القابلة للبرمجة (انظر الإكمال القابل للبرمجة أدناه).

COMP_WORDBREAKS

مجموعة الأحرف التي تعاملها مكتبة readline كفواصل كلمات عند إجراء إكمال الكلمات. إذا أُلغي تعيين COMP_WORDBREAKS، فإنه يفقد خصائصه الخاصة، حتى لو أُعيد تعيينه لاحقاً.

COMP_WORDS

متغير مصفوفة (انظر المصفوفات أدناه) يتكون من الكلمات الفردية في سطر الأوامر الحالي. يُقسم السطر إلى كلمات كما تفعل readline، باستخدام COMP_WORDBREAKS كما هو موضح أعلاه. يتوفر هذا المتغير فقط في وظائف الصدفة المستدعاة بواسطة تسهيلات الإكمال القابلة للبرمجة (انظر الإكمال القابل للبرمجة أدناه).

COPROC

متغير مصفوفة (انظر المصفوفات أدناه) أُنشئ ليحمل واصفات الملفات للمخرجات من والمدخلات إلى عملية مشتركة غير مسماة (انظر العمليات المشتركة أعلاه).

DIRSTACK

متغير مصفوفة (انظر المصفوفات أدناه) يحتوي على المحتويات الحالية لمكدس الأدلة. تظهر الأدلة في المكدس بالترتيب الذي يعرضه الأمر المدمج dirs. يمكن استخدام التعيين لعناصر متغير المصفوفة هذا لتعديل الأدلة الموجودة بالفعل في المكدس، ولكن يجب استخدام الأمرين المدمجين pushd و popd لإضافة وإزالة الأدلة. التعيين لهذا المتغير لا يغير الدليل الحالي. إذا أُلغي تعيين DIRSTACK، فإنه يفقد خصائصه الخاصة، حتى لو أُعيد تعيينه لاحقاً.

EPOCHREALTIME

في كل مرة يُشار فيها إلى هذا المعامل، فإنه يتوسع إلى عدد الثواني منذ حقبة يونكس (انظر time(3)) كقيمة فاصلة عائمة بدقة ميكروثانية. تُتجاهل عمليات التعيين لـ EPOCHREALTIME. إذا أُلغي تعيين EPOCHREALTIME، فإنه يفقد خصائصه الخاصة، حتى لو أُعيد تعيينه لاحقاً.

EPOCHSECONDS

في كل مرة يُشار فيها إلى هذا المعامل، فإنه يتوسع إلى عدد الثواني منذ حقبة يونكس (انظر time(3)). تُتجاهل عمليات التعيين لـ EPOCHSECONDS. إذا أُلغي تعيين EPOCHSECONDS، فإنه يفقد خصائصه الخاصة، حتى لو أُعيد تعيينه لاحقاً.

EUID

يتوسع إلى معرف المستخدم الفعلي للمستخدم الحالي، ويُهيأ عند بدء تشغيل الصدفة. هذا المتغير للقراءة فقط.

FUNCNAME

متغير مصفوفة يحتوي على أسماء جميع وظائف الصدفة الموجودة حالياً في مكدس استدعاءات التنفيذ. العنصر ذو الفهرس 0 هو اسم أي وظيفة صدفة يجري تنفيذها حالياً. العنصر الأكثر انخفاضاً (الذي له أعلى فهرس) هو “main”. يوجد هذا المتغير فقط عند تنفيذ وظيفة صدفة. لا تأثير لعمليات التعيين لـ FUNCNAME. إذا أُلغي تعيين FUNCNAME، فإنه يفقد خصائصه الخاصة، حتى لو أُعيد تعيينه لاحقاً.

يمكن استخدام هذا المتغير مع BASH_LINENO و BASH_SOURCE. لكل عنصر من عناصر FUNCNAME عناصر مقابلة في BASH_LINENO و BASH_SOURCE لوصف مكدس الاستدعاءات. على سبيل المثال، استُدعيت ${FUNCNAME[$i]} من الملف ${BASH_SOURCE[$i+1]} في السطر رقم ${BASH_LINENO[$i]}. يعرض الأمر المدمج caller مكدس الاستدعاءات الحالي باستخدام هذه المعلومات.

GROUPS

متغير مصفوفة يحتوي على قائمة المجموعات التي ينتمي إليها المستخدم الحالي. لا تأثير لعمليات التعيين لـ GROUPS. إذا أُلغي تعيين GROUPS، فإنه يفقد خصائصه الخاصة، حتى لو أُعيد تعيينه لاحقاً.

HISTCMD

رقم التأريخ، أو الفهرس في قائمة التأريخ، للأمر الحالي. لا تؤثر التعيينات في HISTCMD. إذا أُلغي تعيين HISTCMD، فإنها تفقد خصائصها الخاصة، حتى لو أُعيد تعيينها لاحقًا.

HOSTNAME

يُضبط آليًا إلى اسم المضيف الحالي.

HOSTTYPE

يُضبط آليًا إلى سلسلة تصف بشكل فريد نوع الجهاز الذي يشتغل عليه bash. القيمة المبدئية تعتمد على النظام.

LINENO

في كل مرة يُشار فيها إلى هذا المعامل، تستبدله الـ صدفة برقم عشري يمثل رقم السطر التسلسلي الحالي (بدءًا من 1) داخل سكربت أو دالة. عندما لا يكون في سكربت أو دالة، لا يُضمن أن تكون القيمة المستبدلة ذات معنى. إذا أُلغي تعيين LINENO، فإنها تفقد خصائصها الخاصة، حتى لو أُعيد تعيينها لاحقًا.

MACHTYPE

يُضبط آليًا إلى سلسلة تصف تمامًا نوع النظام الذي يشتغل عليه bash، بتنسيق cpu-company-system القياسي لـ GNU. القيمة المبدئية تعتمد على النظام.

MAPFILE

متغير مصفوفة (انظر Arrays أدناه) أُنشئ ليحوي النص المقروء بواسطة أمر mapfile المدمج عند عدم توفير اسم متغير.

OLDPWD

دليل العمل السابق كما عينه الأمر cd.

OPTARG

قيمة آخر معطى خيار عولج بواسطة أمر getopts المدمج (انظر أوامر الصدفة المدمجة أدناه).

OPTIND

فهرس المعطى التالي الذي سيُعالجه أمر getopts المدمج (انظر أوامر الصدفة المدمجة أدناه).

OSTYPE

يُضبط آليًا إلى سلسلة تصف نظام التشغيل الذي يشتغل عليه bash. القيمة المبدئية تعتمد على النظام.

PIPESTATUS

متغير مصفوفة (انظر Arrays أدناه) يحتوي على قائمة بقيم حالة الخروج من الأوامر في آخر أنبوب نفذ في الواجهة، والذي قد يتكون من أمر بسيط واحد فقط (انظر قواعد الصدفة أعلاه). يُعين bash المتغير PIPESTATUS بعد تنفيذ الأنابيب متعددة العناصر، والأنابيب الموقوتة والمنفية، والأوامر البسيطة، والصدفات الفرعية المنشأة باستخدام المعامل (، والأوامر المركبة [[ و ((، وبعد ظروف الخطأ التي تؤدي إلى إجهاض الـ صدفة لتنفيذ الأمر.

PPID

معرف عملية (PID) والد الـ صدفة. هذا المتغير للقراءة فقط.

PWD

دليل العمل الحالي كما عينه الأمر cd.

RANDOM

في كل مرة يُشار فيها إلى هذا المعامل، يتوسع إلى عدد صحيح عشوائي بين 0 و 32767. يؤدي تعيين قيمة لـ RANDOM إلى تهيئة (بذر) تسلسل الأعداد العشوائية. بذر مولد الأعداد العشوائية بنفس القيمة الثابتة ينتج نفس تسلسل القيم. إذا أُلغي تعيين RANDOM، فإنها تفقد خصائصها الخاصة، حتى لو أُعيد تعيينها لاحقًا.

READLINE_ARGUMENT

أي معطى عددي يُعطى لأمر readline عُرّف باستخدام “bind -x” (انظر أوامر الصدفة المدمجة أدناه) عند استدعائه.

READLINE_LINE

محتويات مخزن سطر readline المؤقت، للاستخدام مع “bind -x” (انظر أوامر الصدفة المدمجة أدناه).

READLINE_MARK

موضع الـ علامة (نقطة الإدراج المحفوظة) في مخزن سطر readline المؤقت، للاستخدام مع “bind -x” (انظر أوامر الصدفة المدمجة أدناه). غالبًا ما تسمى الأحرف بين نقطة الإدراج والـ علامة باسم المنطقة.

READLINE_POINT

موضع نقطة الإدراج في مخزن سطر readline المؤقت، للاستخدام مع “bind -x” (انظر أوامر الصدفة المدمجة أدناه).

REPLY

يُضبط على سطر المدخلات المقروء بواسطة أمر read المدمج عند عدم توفير أي معطيات.

SECONDS

في كل مرة يُشار فيها إلى هذا المعامل، فإنه يتوسع إلى عدد الثواني منذ استدعاء الـ صدفة. إذا عُينت قيمة لـ SECONDS، فإن القيمة المرجعة عند الإشارات اللاحقة هي عدد الثواني منذ التعيين زائد القيمة المعينة. يُحدد عدد الثواني عند استدعاء الـ صدفة والوقت الحالي دائمًا عن طريق الاستعلام من ساعة النظام بدقة ثانية واحدة. إذا أُلغي تعيين SECONDS، فإنها تفقد خصائصها الخاصة، حتى لو أُعيد تعيينها لاحقًا.

SHELLOPTS

قائمة مفصولة بنقطتين لخيارات الصدفة المفعّلة. كل كلمة في القائمة هي معامل صحيح للخيار -o الخاص بالأمر المدمج set (انظر أوامر الصدفة المدمجة أدناه). الخيارات التي تظهر في SHELLOPTS هي تلك التي يُبلّغ عنها بأنها on (مفعّلة) بواسطة set -o. إذا كان هذا المتغير موجودًا في البيئة عند بدء تشغيل bash، فستفعّل الصدفة كل خيار في القائمة قبل قراءة أي ملفات بدء تشغيل. إذا صُدّر هذا المتغير، فستفعّل الصدف الأبناء كل خيار في القائمة. هذا المتغير للقراءة فقط.

SHLVL

يُزاد بمقدار واحد في كل مرة يُبدأ فيها تشغيل نسخة من bash.

SRANDOM

في كل مرة يُشار إليه، يتوسع هذا المتغير إلى رقم عشوائي زائف بطول 32 بت. مولد الأرقام العشوائية ليس خطيًا على الأنظمة التي تدعم /dev/urandom أو arc4random(3)، لذا فإن كل رقم ناتج ليس له علاقة بالأرقام التي تسبقه. لا يمكن تزويد مولد الأرقام العشوائية ببذرة (seed)، لذا فإن عمليات التعيين لهذا المتغير ليس لها أي تأثير. إذا أُلغي تعيين SRANDOM، فإنه يفقد خصائصه الخاصة، حتى لو أُعيد تعيينه لاحقًا.

UID

يتوسع إلى معرّف المستخدم (user ID) للمستخدم الحالي، ويُهيّأ عند بدء تشغيل الصدفة. هذا المتغير للقراءة فقط.

تستخدم الصدفة المتغيرات التالية. في بعض الحالات، يُعيّن bash قيمة مبدئية لمتغير ما؛ وتُذكر هذه الحالات أدناه.

BASH_COMPAT

تُستخدم القيمة لضبط مستوى توافق الصدفة. انظر نمط توافق الصدفة أدناه للحصول على وصف لمستويات التوافق المختلفة وآثارها. قد تكون القيمة رقمًا عشريًا (مثل 4.2) أو عددًا صحيحًا (مثل 42) يقابل مستوى التوافق المطلوب. إذا أُلغي تعيين BASH_COMPAT أو عُيّن كسلسلة فارغة، فسيُضبط مستوى التوافق على القيمة المبدئية للإصدار الحالي. إذا عُيّن BASH_COMPAT على قيمة ليست من مستويات التوافق الصالحة، فستطبع الصدفة رسالة خطأ وتضبط مستوى التوافق على القيمة المبدئية للإصدار الحالي. تتوافق مجموعة فرعية من القيم الصالحة مع مستويات التوافق الموصوفة أدناه ضمن نمط توافق الصدفة. على سبيل المثال، 4.2 و 42 هي قيم صالحة تقابل خيار shopt المسمى compat42 وتضبط مستوى التوافق على 42. الإصدار الحالي هو أيضًا قيمة صالحة.

BASH_ENV

إذا عُيّنت هذه المعلمة عندما ينفذ bash سكربت صدفة، فستُفسر قيمتها الموسعة كاسم ملف يحتوي على أوامر لتهيئة الصدفة قبل قراءة وتنفيذ الأوامر من السكربت. تخضع قيمة BASH_ENV لتوسيع المعلمات، واستبدال الأوامر، والتوسيع الحسابي قبل تفسيرها كاسم ملف. لا يُستخدم PATH للبحث عن اسم الملف الناتج.

BASH_XTRACEFD

إذا عُيّن إلى عدد صحيح يقابل واصف ملف صالح، فسيكتب bash مخرجات التتبع المولدة عندما “set -x” يُفعّل إلى واصف الملف هذا، بدلاً من الخطأ القياسي. يُغلق واصف الملف عند إلغاء تعيين BASH_XTRACEFD أو تعيين قيمة جديدة له. يؤدي إلغاء تعيين BASH_XTRACEFD أو تعيينه كسلسلة فارغة إلى إرسال مخرجات التتبع إلى الخطأ القياسي. لاحظ أن تعيين BASH_XTRACEFD على 2 (واصف ملف الخطأ القياسي) ثم إلغاء تعيينه سيؤدي إلى إغلاق الخطأ القياسي.

CDPATH

مسار البحث للأمر cd. هذا عبارة عن قائمة مفصولة بنقطتين من المجلدات حيث تبحث الصدفة عن المجلدات المحددة كمعاملات للأمر cd. قيمة عينة هي “.:~:/usr”.

CHILD_MAX

يضبط عدد قيم حالة الأبناء المنتهية التي يجب أن تتذكرها الصدفة. لن يسمح Bash بتقليل هذه القيمة عن الحد الأدنى الذي يفرضه POSIX ، وهناك قيمة قصوى (حالياً 8192) لا يجوز تجاوزها. الحد الأدنى يعتمد على النظام.

COLUMNS

يستخدمه الأمر المركب select لتحديد عرض الطرفية عند طباعة قوائم الاختيار. يُضبط آليًا إذا فُعّل خيار checkwinsize أو في صدفة تفاعلية عند استلام SIGWINCH.

COMPREPLY

متغير مصفوفة يقرأ منه bash عمليات الإكمال الممكنة التي ولدتها دالة صدفة استدعتها ميزة الإكمال القابلة للبرمجة (انظر الإكمال القابل للبرمجة أدناه). يحتوي كل عنصر في المصفوفة على إكمال واحد ممكن.

EMACS

إذا وجد bash هذا المتغير في البيئة عند بدء تشغيل الصدفة بالقيمة “t”, فإنه يفترض أن الصدفة تعمل في مخزن مؤقت لصدفة Emacs ويعطل تحرير السطور.

ENV

يُوسع ويُنفذ بشكل مشابه لـ BASH_ENV (انظر الاستدعاء أعلاه) عند استدعاء صدفة تفاعلية في نمط posix.

EXECIGNORE

قائمة مفصولة بنقطتين من أنماط الصدفة (انظر مطابقة الأنماط) التي تحدد مجموعة أسماء الملفات التي يجب تجاهلها عند البحث عن الأوامر باستخدام PATH. الملفات التي تطابق مساراتها الكاملة أحد هذه الأنماط لا تُعتبر ملفات قابلة للتنفيذ لأغراض الإكمال وتنفيذ الأوامر عبر البحث في PATH. هذا لا يؤثر على سلوك الأوامر [ و test و [[. لا تخضع المسارات الكاملة في جدول هاش الأوامر لـ EXECIGNORE. استخدم هذا المتغير لتجاهل ملفات المكتبات المشتركة التي تم ضبط بت التنفيذ لها، ولكنها ليست ملفات قابلة للتنفيذ. تحترم مطابقة الأنماط إعداد خيار الصدفة extglob.

FCEDIT

المحرر المبدئي للأمر المدمج fc.

FIGNORE

قائمة مفصولة بنقطتين من اللاحقات التي يجب تجاهلها عند إجراء إكمال أسماء الملفات (انظر READLINE أدناه). يُستبعد اسم الملف الذي تطابق لاحقته أحد المدخلات في FIGNORE من قائمة أسماء الملفات المطابقة. قيمة عينة هي “.o:~” (الاقتباس مطلوب عند تعيين قيمة لهذا المتغير، والذي يحتوي على علامات مدة ~).

FUNCNEST

إذا ضُبط على قيمة عددية أكبر من 0، فإنه يحدد أقصى مستوى لتعشيش الدوال. استدعاءات الدوال التي تتجاوز مستوى التعشيش هذا تؤدي إلى إجهاض الأمر الحالي.

GLOBIGNORE

قائمة مفصولة بنقطتين من الأنماط التي تحدد مجموعة أسماء الملفات التي يجب تجاهلها عند توسيع مسار الملف. إذا كان اسم الملف المطابق لنمط توسيع المسار يطابق أيضًا أحد الأنماط في GLOBIGNORE، فسيُحذف من قائمة المطابقات. تحترم مطابقة الأنماط إعداد خيار الصدفة extglob.

GLOBSORT

يتحكم في كيفية فرز نتائج توسيع مسار الملف. تحدد قيمة هذا المتغير معايير الفرز وترتيبه لنتائج توسيع مسار الملف. إذا كان هذا المتغير غير معين أو معين كسلسلة فارغة، فإن توسيع مسار الملف يستخدم السلوك التاريخي للفرز حسب الاسم، بترتيب معجمي تصاعدي كما يحدده متغير الصدفة LC_COLLATE.

إذا ضُبط، تبدأ القيمة الصالحة بعلامة + اختيارية (تُتجاهل)، أو - التي تعكس ترتيب الفرز من تصاعدي إلى تنازلي، متبوعة بمحدد فرز. محددات الفرز الصالحة هي name و numeric و size و mtime و atime و ctime و blocks، والتي تفرز الملفات حسب الاسم، والأسماء بترتيب عددي بدلاً من المعجمي، وحجم الملف، ووقت التعديل، ووقت الوصول، ووقت تغيير inode، وعدد الكتل، على التوالي. إذا تساوت أي من المفاتيح غير الاسمية (مثل تساوي حجم ملفين)، فسيُستخدم الاسم كمفتاح فرز ثانوي.

على سبيل المثال، القيمة -mtime تفرز النتائج بترتيب تنازلي حسب وقت التعديل (الأحدث أولاً).

يعامل المحدد numeric الأسماء المكونة من أرقام فقط كأرقام ويفرزها باستخدام قيمتها العددية (لذا فإن “2” تُفرز قبل “10”, على سبيل المثال). عند استخدام numeric، تُفرز الأسماء التي تحتوي على غير الأرقام بعد جميع الأسماء المكونة من أرقام فقط، وتُفرز حسب الاسم باستخدام السلوك التقليدي.

يؤدي محدد الفرز nosort إلى تعطيل الفرز تماماً؛ حيث يعيد bash النتائج بالترتيب الذي قُرئت به من نظام الملفات، متجاهلاً أي علامة - في البداية.

إذا كان محدد الفرز مفقوداً، فإنه يُفترض كونه name مبدئياً، لذا فإن القيمة + تعادل السلسلة الفارغة، والقيمة - تفرز حسب الاسم بترتيب تنازلي. أي قيمة غير صالحة تستعيد سلوك الفرز التاريخي.

HISTCONTROL

قائمة مفصولة بنقطتين من القيم التي تتحكم في كيفية حفظ الأوامر في قائمة التاريخ. إذا تضمنت قائمة القيم ignorespace، فلن تُحفظ السطور التي تبدأ بمسافة (space) في قائمة التاريخ. وتؤدي القيمة ignoredups إلى عدم حفظ السطور المطابقة لمدخل التاريخ السابق. القيمة ignoreboth هي اختصار لـ ignorespace و ignoredups. وتؤدي القيمة erasedups إلى حذف جميع السطور السابقة المطابقة للسطر الحالي من قائمة التاريخ قبل حفظ هذا السطر. تُتجاهل أي قيمة ليست في القائمة أعلاه. إذا كان HISTCONTROL غير معين، أو لا يتضمن قيمة صالحة، فسيحفظ bash جميع السطور التي يقرأها محلل الصدفة في قائمة التاريخ، مع مراعاة قيمة HISTIGNORE. إذا حُفظ السطر الأول من أمر مركب متعدد الأسطر، فلن تُختبر الأسطر الثانية واللاحقة، وتُضاف إلى التاريخ بغض النظر عن قيمة HISTCONTROL. وإذا لم يُحفظ السطر الأول، فلن تُحفظ الأسطر الثانية واللاحقة من الأمر أيضًا.

HISTFILE

اسم الملف الذي يُحفظ فيه تأريخ الأوامر (انظر التأريخ أدناه). يُعين Bash قيمة مبدئية هي ~/.bash_history. إذا أُلغي تعيين HISTFILE أو كانت فارغة، فلن تحفظ الـ صدفة تأريخ الأوامر عند خروجها.

HISTFILESIZE

الحد الأقصى لعدد الأسطر التي يحتوي عليها ملف التأريخ. عند تعيين قيمة لهذا المتغير، يتم اقتطاع ملف التأريخ، إذا لزم الأمر، ليحتوي على ما لا يزيد عن عدد مدخلات التأريخ التي لا يتجاوز مجموعها ذلك العدد من الأسطر عن طريق إزالة أقدم المدخلات. إذا كانت قائمة التأريخ تحتوي على مدخلات متعددة الأسطر، فقد يحتوي ملف التأريخ على أسطر أكثر من هذا الحد الأقصى لتجنب ترك مدخلات تأريخ جزئية. يتم أيضًا اقتطاع ملف التأريخ إلى هذا الحجم بعد كتابته عند خروج صدفة أو بواسطة أمر history المدمج. إذا كانت القيمة 0، يتم اقتطاع ملف التأريخ إلى حجم صفر. القيم غير العددية والقيم العددية الأقل من الصفر تمنع الاقتطاع. تضبط الـ صدفة القيمة المبدئية على قيمة HISTSIZE بعد قراءة أي ملفات بدء تشغيل.

HISTIGNORE

قائمة مفصولة بنقطتين من الأنماط المستخدمة لتحديد أي أسطر الأوامر يجب حفظها في قائمة التأريخ. إذا طابق سطر الأوامر أحد الأنماط في قيمة HISTIGNORE، فلن يُحفظ في قائمة التأريخ. كل نمط مثبت في بداية السطر ويجب أن يطابق السطر بالكامل (لا يلحق bash ضمنيًا “*”). يُختبر كل نمط مقابل السطر بعد تطبيق الفحوصات المحددة بواسطة HISTCONTROL. بالإضافة إلى أحرف مطابقة أنماط الـ صدفة العادية، “&” يطابق سطر التأريخ السابق. تستخدم الشرطة المائلة العكسية للهروب من “&”; تُزال الشرطة المائلة العكسية قبل محاولة المطابقة. إذا حُفظ السطر الأول من أمر مركب متعدد الأسطر، فلن تُختبر الأسطر الثانية واللاحقة، وستُضاف إلى التأريخ بغض النظر عن قيمة HISTIGNORE. إذا لم يُحفظ السطر الأول، فلن تُحفظ الأسطر الثانية واللاحقة من الأمر أيضًا. تحترم مطابقة الأنماط إعداد خيار الـ صدفة extglob.

تتضمن HISTIGNORE بعض وظائف HISTCONTROL. نمط “&” مطابق لـ “ignoredups”, ونمط “[ ]*” مطابق لـ “ignorespace”. الجمع بين هذين النمطين، مع الفصل بينهما بنقطتين، يوفر وظيفة “ignoreboth”.

HISTSIZE

عدد الأوامر التي يجب تذكرها في تأريخ الأوامر (انظر التأريخ أدناه). إذا كانت القيمة 0، فلن تُحفظ الأوامر في قائمة التأريخ. تؤدي القيم العددية الأقل من الصفر إلى حفظ كل أمر في قائمة التأريخ (لا يوجد حد). تضبط الـ صدفة القيمة المبدئية على 500 بعد قراءة أي ملفات بدء تشغيل.

HISTTIMEFORMAT

إذا عُين هذا المتغير ولم يكن فارغًا، تُستخدم قيمته كسلسلة تنسيق لـ strftime(3) لطباعة الطابع الزمني المرتبط بكل مدخل تأريخ يعرضه أمر history المدمج. إذا عُين هذا المتغير، تكتب الـ صدفة طوابع زمنية في ملف التأريخ بحيث يمكن الحفاظ عليها عبر جلسات الـ صدفة. يستخدم هذا حرف تعليق التأريخ لتمييز الطوابع الزمنية عن أسطر التأريخ الأخرى.

HOME

الدليل الرئيسي للمستخدم الحالي؛ المعطى المبدئي للأمر المدمج cd. تُستخدم قيمة هذا المتغير أيضًا عند إجراء توسيع التلدة (tilde).

HOSTFILE

يحتوي على اسم ملف بنفس تنسيق /etc/hosts الذي يجب قراءته عندما تحتاج الـ صدفة إلى إكمال اسم مضيف. قد تُغير قائمة إكمالات أسماء المضيفين الممكنة أثناء تشغيل الـ صدفة؛ في المرة التالية التي تُحاول فيها إكمال اسم المضيف بعد تغيير القيمة، يضيف bash محتويات الملف الجديد إلى القائمة الموجودة. إذا عُين HOSTFILE، ولكن ليس له قيمة، أو لا يسمي ملفًا قابلاً للقراءة، يحاول bash قراءة /etc/hosts للحصول على قائمة إكمالات أسماء المضيفين الممكنة. عند إلغاء تعيين HOSTFILE، يمسح bash قائمة أسماء المضيفين.

IFS

فاصل الحقول الداخلي الذي يُستخدم لتقسيم الكلمات بعد التوسع ولتقسيم الأسطر إلى كلمات باستخدام أمر read المدمج. يوصف تقسيم الكلمات أدناه تحت التوسع. القيمة المبدئية هي “<space><tab><newline>”.

IGNOREEOF

يتحكم في إجراء صدفة تفاعلية عند استلام محرف EOF كمدخل وحيد. إذا عُين، فإن القيمة هي عدد محارف EOF المتتالية التي يجب كتابتها كأول محارف في سطر الإدخال قبل خروج bash. إذا عُين المتغير ولكن ليس له قيمة عددية، أو كانت القيمة فارغة، فإن القيمة المبدئية هي 10. إذا أُلغي تعيينه، فإن EOF تعني نهاية الإدخال للـ صدفة.

INPUTRC

اسم ملف بدء تشغيل readline، متجاوزًا القيمة المبدئية لـ ~/.inputrc (انظر READLINE أدناه).

INSIDE_EMACS

إذا ظهر هذا المتغير في البيئة عند بدء تشغيل الـ صدفة، يفترض bash أنه يعمل داخل مخزن صدفة Emacs وقد يعطل تحرير السطر، اعتمادًا على قيمة TERM.

LANG

يُستخدم لتحديد فئة الإعدادات المحلية لأي فئة لم تُحدد صراحة بمتغير يبدأ بـ LC_.

LC_ALL

يتجاوز هذا المتغير قيمة LANG وأي متغير LC_ آخر يحدد فئة إعدادات محلية.

LC_COLLATE

يحدد هذا المتغير ترتيب المقارنة المستخدم عند فرز نتائج توسيع مسار الملف، ويحدد سلوك تعبيرات النطاق، وفئات التكافؤ، وتسلسلات المقارنة داخل توسيع مسار الملف ومطابقة الأنماط.

LC_CTYPE

يحدد هذا المتغير تفسير المحارف وسلوك فئات المحارف داخل توسيع مسار الملف ومطابقة الأنماط.

LC_MESSAGES

يحدد هذا المتغير الإعدادات المحلية المستخدمة لترجمة السلاسل الموضوعة بين علامتي اقتباس مزدوجتين والمسبوقة بـ $.

LC_NUMERIC

يحدد هذا المتغير فئة الإعدادات المحلية المستخدمة لتنسيق الأرقام.

LC_TIME

يحدد هذا المتغير فئة الإعدادات المحلية المستخدمة لتنسيق التاريخ والوقت.

LINES

يستخدمه الأمر المركب select لتحديد طول العمود عند طباعة قوائم الاختيار. يُضبط آليًا إذا مُكّن خيار checkwinsize أو في صدفة تفاعلية عند تلقي إشارة SIGWINCH.

MAIL

إذا عُينت القيمة لاسم ملف أو دليل ولم يُعين متغير MAILPATH، فإن bash يخبر المستخدم بوصول بريد في الملف المحدد أو الدليل بتنسيق Maildir.

MAILCHECK

يحدد عدد المرات (بالثواني) التي يتحقق فيها bash من البريد. القيمة المبدئية هي 60 ثانية. عندما يحين وقت التحقق من البريد، تقوم الـ صدفة بذلك قبل عرض المحث الرئيس. إذا أُلغي تعيين هذا المتغير، أو عُين لقيمة ليست رقمًا أكبر من أو يساوي الصفر، فإن الـ صدفة تعطّل التحقق من البريد.

MAILPATH

قائمة مفصولة بنقطتين لأسماء الملفات التي سيتم التحقق منها بحثًا عن بريد. يمكن تحديد الرسالة التي ستُطبع عند وصول بريد في ملف معين عن طريق فصل اسم الملف عن الرسالة بـ “?”. عند استخدامه في نص الرسالة، يتوسع $_ إلى اسم ملف البريد الحالي. على سبيل المثال:

MAILPATH='/var/mail/bfox?"لديك بريد":~/shell-mail?"$_ لديه بريد!"'

OPTERR

إذا عُين للقيمة 1، يعرض bash رسائل الخطأ الناتجة عن أمر getopts المدمج (انظر أوامر الصدفة المدمجة أدناه). يُهيأ OPTERR إلى 1 في كل مرة تُستدعى فيها الـ صدفة أو يُنفذ فيها سكربت صدفة.

PATH

مسار البحث عن الأوامر. وهو قائمة مفصولة بنقطتين للأدلة التي تبحث فيها الـ صدفة عن الأوامر (انظر تنفيذ الأوامر أدناه). اسم الدليل بطول صفر (null) في قيمة PATH يشير إلى الدليل الحالي. قد يظهر اسم دليل فارغ كنقطتين متجاورتين، أو كنقطة في البداية أو النهاية. المسار المبدئي يعتمد على النظام، ويضبطه المسؤول الذي يثبت bash. القيمة الشائعة هي

/usr/local/bin:/usr/local/sbin:.if  0<78n .br
/usr/bin:/usr/sbin:/bin:/sbin

POSIXLY_CORRECT

إذا كان هذا المتغير في البيئة عند بدء تشغيل bash، تدخل الـ صدفة في وضع posix قبل قراءة ملفات بدء التشغيل، كما لو كان خيار الاستدعاء --posix قد تم توفيره. إذا عُين أثناء تشغيل الـ صدفة، يُمكّن bash وضع posix، كما لو كان الأمر “set -o posix” قد نُفذ. عندما تدخل الـ صدفة في وضع posix، فإنها تضبط هذا المتغير إذا لم يكن قد عُين بالفعل.

PROMPT_COMMAND

إذا عُين هذا المتغير، وكان مصفوفة، تُنفذ قيمة كل عنصر معين كأمر قبل إصدار كل محث رئيس. إذا عُين هذا المتغير ولكن لم يكن مصفوفة، تُستخدم قيمته كأمر ليُنقذ بدلاً من ذلك.

PROMPT_DIRTRIM

إذا ضُبطت على رقم أكبر من الصفر، تُستخدم القيمة كعدد لمكونات المسار اللاحقة التي يُحتفظ بها عند توسيع هروب سلاسل المحث \w و \W (انظر PROMPTING أدناه). تُستبدل المحارف المحذوفة بنقاط حذف.

PS0

تُوسع قيمة هذا المعامل (انظر PROMPTING أدناه) وتعرضها الصدف التفاعلية بعد قراءة الأمر وقبل تنفيذه.

PS1

تُوسع قيمة هذا المعامل (انظر PROMPTING أدناه) وتُستخدم كسلسلة المحث الرئيسة. القيمة المبدئية هي “\s-\v\$ ”.

PS2

تُوسع قيمة هذا المعامل كما هو الحال مع PS1 وتُستخدم كسلسلة المحث الثانوية. المبدئي هو “> ”.

PS3

تُستخدم قيمة هذا المعامل كمحث لأمر select (انظر SHELL GRAMMAR أعلاه).

PS4

تُوسع قيمة هذا المعامل كما هو الحال مع PS1 وتُطبع القيمة قبل كل أمر يعرضه bash أثناء تتبع التنفيذ. يُكرر المحرف الأول من القيمة الموسعة لـ PS4 عدة مرات، حسب الضرورة، للإشارة إلى مستويات متعددة من الاستدلال. المبدئي هو “+ ”.

SHELL

يتوسع هذا المتغير إلى مسار الاسم الكامل للصدفة. إذا لم يُضبط عند بدء تشغيل الصدفة، يخصص bash له مسار الاسم الكامل لصدفة ولوج المستخدم الحالي.

TIMEFORMAT

تُستخدم قيمة هذا المعامل كسلسلة تنسيق تحدد كيفية عرض معلومات التوقيت للأنابيب المسبوقة بالكلمة المحجوزة time. يقدم محرف % تسلسل هروب يُوسع إلى قيمة زمنية أو معلومات أخرى. تسلسلات الهروب ومعانيها هي كما يلي؛ وتشير الأقواس المربعة إلى الأجزاء الاختيارية.

الخيار p هو رقم يحدد الدقة، أي عدد الأرقام الكسرية بعد الفاصلة العشرية. تؤدي القيمة 0 إلى عدم إخراج فاصلة عشرية أو كسر. يطبع time ستة أرقام كحد أقصى بعد الفاصلة العشرية؛ تُغير قيم p الأكبر من 6 إلى 6. إذا لم يُحدد p، يطبع time ثلاثة أرقام بعد الفاصلة العشرية.

يحدد الخيار l تنسيقاً أطول، يتضمن الدقائق، على شكل MMmSS.FFs. تحدد قيمة p ما إذا كان الكسر سيُضمّن أم لا.

إذا لم يُضبط هذا المتغير، يتصرف bash كما لو كانت قيمته $'\nreal\t%3lR\nuser\t%3lU\nsys\t%3lS'. إذا كانت القيمة فارغة، لا يعرض bash أي معلومات توقيت. يُضاف سطر جديد لاحق عند عرض سلسلة التنسيق.

TMOUT

إذا ضُبط على قيمة أكبر من الصفر، يستخدم الأمر المدمج read القيمة كمهلة مبدئية له. ينتهي أمر select إذا لم يصل دخل بعد TMOUT ثانية عندما يكون الدخل آتياً من طرفية. في الصدفة التفاعلية، تُفسر القيمة على أنها عدد الثواني لانتظار سطر من الدخل بعد إصدار المحث الرئيس. ينتهي Bash بعد الانتظار لهذا العدد من الثواني إذا لم يصل سطر كامل من الدخل.

TMPDIR

إذا ضُبط، يستخدم bash قيمته كاسم لدليل ينشئ فيه bash ملفات مؤقتة لاستخدام الصدفة.

auto_resume

يتحكم هذا المتغير في كيفية تفاعل الصدفة مع المستخدم والتحكم في المهام. إذا ضُبط هذا المتغير، تُعامل الأوامر البسيطة المكونة من كلمة واحدة فقط، بدون إعادة توجيه، كمرشحات لاستئناف مهمة متوقفة موجودة. لا يُسمح بأي غموض؛ إذا كان هناك أكثر من مهمة تبدأ بالكلمة أو تحتوي عليها، يختار هذا المتغير المهمة التي تم الوصول إليها مؤخراً. اسم المهمة المتوقفة، في هذا السياق، هو سطر الأوامر المستخدم لبدئها، كما يعرضه jobs. إذا ضُبط على القيمة exact، يجب أن تطابق الكلمة اسم المهمة المتوقفة تماماً؛ وإذا ضُبط على substring، يجب أن تطابق الكلمة سلسلة فرعية من اسم المهمة المتوقفة. توفر القيمة substring وظيفة مماثلة لمعرف المهمة %? (انظر JOB CONTROL أدناه). إذا ضُبط على أي قيمة أخرى (مثلاً prefix)، يجب أن تكون الكلمة سابقة لاسم المهمة المتوقفة؛ وهذا يوفر وظيفة مماثلة لمعرف المهمة %string.

histchars

المحرفان أو الثلاثة محارف التي تتحكم في توسيع التاريخ، والاستبدال السريع، والتقطيع (انظر HISTORY EXPANSION أدناه). المحرف الأول هو محرف توسيع التاريخ، وهو المحرف الذي يبدأ توسيع التاريخ، وعادة ما يكون “!”. المحرف الثاني هو محرف الاستبدال السريع، وعادة ما يكون “^”. عندما يظهر كأول محرف في السطر، يكرر استبدال التاريخ الأمر السابق، مستبدلاً سلسلة بأخرى. المحرف الثالث الاختياري هو محرف تعليق التاريخ، وعادة ما يكون “#”, والذي يشير إلى أن بقية السطر عبارة عن تعليق عندما يظهر كأول محرف في كلمة. يعطل محرف تعليق التاريخ استبدال التاريخ للكلمات المتبقية في السطر. ولا يؤدي بالضرورة إلى جعل محلل الصدفة يعامل بقية السطر كتعليق.

المصفوفات¶

يوفر Bash متغيرات مصفوفة مفهرسة وترابطية أحادية البعد. يمكن استخدام أي متغير كمصفوفة مفهرسة؛ ويصرح الأمر المدمج declare صراحةً عن مصفوفة. لا يوجد حد أقصى لحجم المصفوفة، ولا أي اشتراط بأن تُفهرس الأعضاء أو تُخصص بشكل متجاوز. يُشار إلى المصفوفات المفهرسة باستخدام تعابير حسابية يجب أن تتوسع إلى عدد صحيح (انظر ARITHMETIC EVALUATION أدناه) وتكون مبنية على الصفر؛ ويُشار إلى المصفوفات الترابطية باستخدام سلاسل عشوائية. ما لم يُذكر خلاف ذلك، يجب أن تكون فهارس المصفوفة المفهرسة أعداداً صحيحة غير سالبة.

تجري الصدفة توسيع المعاملات والمتغيرات، والتوسيع الحسابي، واستبدال الأوامر، وإزالة الاقتباس على أدلة المصفوفة المفهرسة. ونظراً لأن هذا قد يؤدي بالضرورة إلى سلاسل فارغة، فإن فهرسة الأدلة تعاملها كتعبيرات تُقيم إلى 0.

تجري الصدفة توسيع المد، وتوسيع المعاملات والمتغيرات، والتوسيع الحسابي، واستبدال الأوامر، وإزالة الاقتباس على أدلة المصفوفة الترابطية. لا يمكن استخدام السلاسل الفارغة كمفاتيح للمصفوفة الترابطية.

ينشئ Bash مصفوفة مفهرسة آلياً إذا خُصص أي متغير باستخدام الصيغة

تُنشأ المصفوفات الترابطية باستخدام

يمكن تحديد السمات لمتغير مصفوفة باستخدام الأوامر المدمجة declare و readonly. تنطبق كل سمة على جميع أعضاء المصفوفة.

تُخصص المصفوفات باستخدام تخصيصات مركبة على شكل name=(value1 ... valuen)، حيث يمكن أن تكون كل value على شكل [subscript]=string. لا تتطلب تخصيصات المصفوفة المفهرسة أي شيء سوى string. تُوسع كل value في القائمة باستخدام توسيعات الصدفة الموضحة أدناه في EXPANSION، لكن الـ values التي تعتبر تخصيصات متغيرات صالحة بما في ذلك الأقواس والدليل لا تخضع لتوسيع الأقواس وتقسيم الكلمات، كما هو الحال مع تخصيصات المتغيرات الفردية.

عند التخصيص للمصفوفات المفهرسة، إذا وُفرت الأقواس والدليل الاختياريين، يُخصص ذلك الفهرس؛ وإلا فإن فهرس العنصر المخصص هو آخر فهرس خُصص بواسطة الجملة زائد واحد. تبدأ الفهرسة من الصفر.

عند التخصيص لمصفوفة ترابطية، قد تكون الكلمات في التخصيص المركب إما جمل تخصيص، والتي تتطلب دليلاً، أو قائمة من الكلمات التي تُفسر كتسلسل من المفاتيح والقيم المتبادلة: name=( key1 value1 key2 value2 ...). تُعامل هذه بشكل مطابق لـ name=( [key1]=value1 [key2]=value2 ...). تحدد الكلمة الأولى في القائمة كيفية تفسير الكلمات المتبقية؛ ويجب أن تكون جميع التخصيصات في القائمة من نفس النوع. عند استخدام أزواج المفاتيح/القيم، لا يمكن أن تكون المفاتيح مفقودة أو فارغة؛ وتُعامل القيمة النهائية المفقودة كسلسلة فارغة.

هذه الصيغة مقبولة أيضاً من قبل الأمر المدمج declare. يمكن تخصيص عناصر المصفوفة الفردية باستخدام صيغة name[subscript]=value المقدمة أعلاه.

عند التخصيص لمصفوفة مفهرسة، إذا كان name متبوعاً بدليل رقمي سالب، يُفسر هذا الرقم كقيمة نسبية لواحد أكبر من أقصى فهرس لـ name، لذا فإن الفهارس السالبة تعد تنازلياً من نهاية المصفوفة، ويشير الفهرس -1 إلى العنصر الأخير.

العامل “+=” يُلحق بمتغير المصفوفة عند التخصيص باستخدام صيغة التخصيص المركبة؛ انظر PARAMETERS أعلاه.

يُشار إلى عنصر المصفوفة باستخدام ${name[subscript]}. الأقواس مطلوبة لتجنب التعارض مع توسيع مسار الاسم. إذا كان subscript هو @ أو *، تتوسع الكلمة إلى جميع أعضاء name، ما لم يُذكر خلاف ذلك في وصف أمر مدمج أو توسيع كلمة. تختلف هذه الأدلة فقط عندما تظهر الكلمة داخل علامتي اقتباس مزدوجتين. إذا كانت الكلمة داخل اقتباس مزدوج، تتوسع ${name[*]} إلى كلمة واحدة بقيمة كل عضو في المصفوفة مفصولة بالمحرف الأول من متغير IFS الخاص، وتتوسع ${name[@]} لكل عنصر من name إلى كلمة منفصلة. عندما لا يكون هناك أعضاء في المصفوفة، تتوسع ${name[@]} إلى لا شيء. إذا حدث التوسيع داخل اقتباس مزدوج ضمن كلمة، يُضم توسيع المعامل الأول مع الجزء الأولي من توسيع الكلمة الأصلية، ويُضم توسيع المعامل الأخير مع الجزء الأخير من توسيع الكلمة الأصلية. وهذا يماثل توسيع المعاملات الخاصة * و @ (انظر Special Parameters أعلاه).

${#name[subscript]} تتوسع إلى طول ${name[subscript]}. إذا كان subscript هو * أو @، يكون التوسع هو عدد العناصر في المصفوفة.

إذا كان subscript المستخدم للإشارة إلى عنصر في مصفوفة مفهرسة يُقيم إلى رقم أقل من الصفر، فإنه يُفسر كقيمة نسبية لواحد أكبر من الفهرس الأقصى للمصفوفة، لذا فإن الفهارس السالبة تعد تنازلياً من نهاية المصفوفة، ويشير الفهرس -1 إلى العنصر الأخير.

الإشارة إلى متغير مصفوفة بدون دليل تعادل الإشارة إلى المصفوفة بالدليل 0. أي إشارة إلى متغير باستخدام دليل صالح تعتبر صالحة؛ وينشئ bash مصفوفة إذا لزم الأمر.

يعتبر متغير المصفوفة معيناً إذا خُصصت قيمة لدليل ما. وتعتبر السلسلة الفارغة قيمة صالحة.

من الممكن الحصول على مفاتيح (فهارس) مصفوفة بالإضافة إلى القيم. تتوسع ${!name[@]} و ${!name[*]} إلى الفهارس المخصصة في متغير المصفوفة name. المعاملة عند وجودها داخل اقتباس مزدوج تشبه توسيع المعاملات الخاصة @ و * داخل الاقتباس المزدوج.

يُستخدم الأمر المدمج unset لتدمير المصفوفات. unset name[subscript] يلغي تعيين عنصر المصفوفة عند الفهرس subscript، لكل من المصفوفات المفهرسة والترابطية. تُفسر الأدلة السالبة للمصفوفات المفهرسة كما هو موضح أعلاه. لا يؤدي إلغاء تعيين العنصر الأخير في متغير مصفوفة إلى إلغاء تعيين المتغير نفسه. unset name، حيث name مصفوفة، يزيل المصفوفة بأكملها. يتصرف unset name[subscript] بشكل مختلف اعتماداً على ما إذا كان name مصفوفة مفهرسة أو ترابطية عندما يكون subscript هو * أو @. إذا كان name مصفوفة ترابطية، فإن هذا يلغي تعيين العنصر ذي الدليل * أو @. إذا كان name مصفوفة مفهرسة، فإن unset يزيل جميع العناصر ولكنه لا يزيل المصفوفة نفسها.

عند استخدام اسم متغير مع دليل كمعامل لأمر ما، كما هو الحال مع unset، بدون استخدام صيغة توسيع الكلمة الموضحة أعلاه (مثلاً unset a[4])، يخضع المعامل لتوسيع مسار الاسم. اقتبس المعامل إذا كان توسيع مسار الاسم غير مرغوب فيه (مثلاً unset 'a[4]').

تقبل الأوامر المدمجة declare و local و readonly خيار -a لتحديد مصفوفة مفهرسة وخيار -A لتحديد مصفوفة ترابطية. إذا وُفر كلا الخيارين، تكون الأولوية لـ -A. يقبل الأمر المدمج read خيار -a لتخصيص قائمة كلمات مقروءة من الدخل القياسي لمصفوفة. يعرض الأممران المدمجان set و declare قيم المصفوفة بطريقة تسمح بإعادة استخدامها كتخصيصات. تقبل أوامر مدمجة أخرى معاملات أسماء مصفوفات أيضاً (مثلاً mapfile)؛ انظر أوصاف الأوامر المدمجة الفردية أدناه للحصول على التفاصيل. توفر الصدفة عدداً من متغيرات المصفوفة المدمجة.

توسيع الأقواس¶

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

قد يكون توسيع الأقواس متداخلاً. لا تُفرز نتائج كل سلسلة موسعة؛ يحافظ توسيع الأقواس على الترتيب من اليسار إلى اليمين. على سبيل المثال، يتوسع a{d,c,b}e إلى “ade ace abe”.

يأخذ تعبير التسلسل الشكل x..y[..incr]، حيث x و y إما أعداد صحيحة أو أحرف مفردة، و incr، وهي زيادة اختيارية، عبارة عن عدد صحيح. عند توفير أعداد صحيحة، يتوسع التعبير لكل رقم بين x و y، بما في ذلك الطرفان. إذا بدأ أي من x أو y بصفر، فسيحتوي كل مصطلح مولد على نفس عدد الأرقام، مع حشو أصفار عند الضرورة. عند توفير أحرف، يتوسع التعبير لكل محرف معجمياً بين x و y، بما في ذلك الطرفان، باستخدام محلي C. لاحظ أنه يجب أن يكون كل من x و y من نفس النوع (عدد صحيح أو حرف). عند توفير الزيادة، تُستخدم كفرق بين كل مصطلح. الزيادة المبدئية هي 1 أو -1 حسب الاقتضاء.

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

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

يمكن “{” أو Q , اقتباسهما بشرطة مائلة خلفية لمنع اعتبارهما جزءاً من تعبير القوس. لتجنب التعارض مع توسيع المعاملات، السلسلة “${” لا تعتبر مؤهلة لتوسيع الأقواس، وتمنع توسيع الأقواس حتى إغلاق “}”.

يُستخدم هذا التركيب عادة كاختصار عندما تكون السابقة المشتركة للسلاسل المراد توليدها أطول مما في المثال أعلاه:

mkdir /usr/local/src/bash/{old,new,dist,bugs}

chown root /usr/{ucb/{ex,edit},lib/{ex?.?*,how_ex}}

يؤدي توسيع الأقواس إلى عدم توافق طفيف مع الإصدارات التاريخية من sh. لا يعامل sh أقواس الفتح أو الإغلاق بشكل خاص عندما تظهر كجزء من كلمة، ويحفظها في المخرجات. يزيل Bash الأقواس من الكلمات كنتيجة لتوسيع الأقواس. على سبيل المثال، الكلمة التي تُدخل إلى sh كـ “file{1,2}” تظهر بشكل متطابق في المخرجات. يخرج Bash تلك الكلمة كـ “file1 file2” بعد توسيع الأقواس. ابدأ bash بخيار +B أو عطل توسيع الأقواس باستخدام خيار +B لأمر set (انظر SHELL BUILTIN COMMANDS أدناه) للتوافق الصارم مع sh.

توسيع المد¶

إذا بدأت كلمة بمحرف مد غير مقتبس ( “~”), تُعتبر جميع المحارف التي تسبق أول شرطة مائلة غير مقتبسة (أو جميع المحارف، إذا لم يكن هناك شرطة مائلة غير مقتبسة) بادئة مد. إذا لم يكن أي من المحارف في بادئة المد مقتبساً، تُعامل المحارف في بادئة المد التي تلي المد كـ اسم ولوج محتمل. إذا كان اسم الولوج هذا هو السلسلة الفارغة، يُستبدل المد بقيمة معامل الصدفة HOME. إذا كان HOME غير معين، يتوسع المد إلى الدليل المنزلي للمستخدم الذي ينفذ الصدفة بدلاً من ذلك. وإلا، تُستبدل بادئة المد بالدليل المنزلي المرتبط باسم الولوج المحدد.

إذا كانت بادئة المد “~+”, تحل قيمة متغير الصدفة PWD محل بادئة المد. إذا كانت بادئة المد “~-”, تستبدل الصدفة قيمة متغير الصدفة OLDPWD، إذا كان معيناً. إذا كانت المحارف التي تلي المد في بادئة المد تتكون من رقم N، مسبوقاً اختيارياً بـ “+” أو “-”, تُستبدل بادئة المد بالعنصر المقابل من مكدس الدليل، كما يعرضه الأمر المدمج dirs المستدعى مع المحارف التي تلي المد في بادئة المد كمعامل. إذا كانت المحارف التي تلي المد في بادئة المد تتكون من رقم بدون بادئة “+” أو “-”, يفترض توسيع المد “+”.

تُعامل نتائج توسيع المد كما لو كانت مقتبسة، لذا لا يخضع الاستبدال لتقسيم الكلمات وتوسيع مسار الاسم.

إذا كان اسم الولوج غير صالح، أو فشل توسيع المد، تظل بادئة المد دون تغيير.

يفحص Bash كل تخصيص متغير لبادئات المد غير المقتبسة التي تلي مباشرة : أو أول =، ويجري توسيع المد في هذه الحالات. وبالتالي، يمكن للمرء استخدام أسماء الملفات مع المد في التخصيصات لـ PATH و MAILPATH و CDPATH، وتخصص الصدفة القيمة الموسعة.

يجري Bash أيضاً توسيع المد على الكلمات التي تستوفي شروط تخصيصات المتغيرات (كما هو موضح أعلاه في PARAMETERS) عندما تظهر كمعاملات لأوامر بسيطة. لا يفعل Bash ذلك، باستثناء أوامر التصريح المذكورة أعلاه، عندما يكون في وضع posix.

توسيع المعاملات¶

العامل “$” يقدم المحرف توسيع المعاملات، أو استبدال الأوامر، أو التوسيع الحسابي. قد يُحاط اسم المعامل أو الرمز المراد توسيعه بأقواس، وهي اختيارية ولكنها تعمل على حماية المتغير المراد توسيعه من المحارف التي تليه مباشرة والتي يمكن تفسيرها كجزء من الاسم.

عند استخدام الأقواس، يكون قوس الإغلاق المطابق هو أول “}” غير مهرب بشرطة مائلة خلفية أو داخل سلسلة مقتبسة، وليس داخل توسيع حسابي مضمن، أو استبدال أمر، أو توسيع معامل.

الشكل الأساسي لتوسيع المعامل هو

${parameter}

والذي يستبدل قيمة parameter. الأقواس مطلوبة عندما يكون parameter معاملاً موضعياً مكوناً من أكثر من رقم واحد، أو عندما يتبع parameter محرف لا يجب تفسيره كجزء من اسمه. parameter هو معامل صدفة كما هو موضح أعلاه (PARAMETERS) أو مرجع مصفوفة (Arrays).

إذا كان المحرف الأول من parameter هو علامة تعجب (!)، ولم يكن parameter مرجع اسم nameref، فإنه يقدم مستوى من الاستدلال. يستخدم Bash القيمة المتكونة من توسيع بقية parameter كـ parameter جديد؛ ثم يُوسع هذا المعامل الجديد وتُستخدم تلك القيمة في بقية التوسيع، بدلاً من توسيع parameter الأصلي. يُعرف هذا باسم التوسيع غير المباشر. تخضع القيمة لتوسيع المد، وتوسيع المعاملات، واستبدال الأوامر، والتوسيع الحسابي. إذا كان parameter مرجع اسم، فإن هذا يتوسع إلى اسم المعامل المشار إليه بواسطة parameter بدلاً من إجراء التوسيع غير المباشر الكامل، وذلك للتوافق. الاستثناءات من ذلك هي توسيعات ${!prefix*} و ${!name[@]} الموضحة أدناه. يجب أن تتبع علامة التعجب مباشرة قوس الفتح لتقديم الاستدلال.

في كل حالة من الحالات أدناه، تخضع word لتوسيع المد، وتوسيع المعاملات، واستبدال الأوامر، والتوسيع الحسابي.

عند عدم إجراء توسيع للسلسلة الفرعية، باستخدام الأشكال الموثقة أدناه (مثلاً :-)، يختبر bash ما إذا كان المعامل غير معين أو فارغاً. يؤدي حذف النقطتين الرأسيتين إلى اختبار ما إذا كان المعامل غير معين فقط.

${parameter:-word}

استخدام القيم المبدئية. إذا كان parameter غير معين أو فارغاً، يُستبدل بتوسيع word. وإلا، تُستبدل قيمة parameter.

${parameter:=word}

تخصيص القيم المبدئية. إذا كان parameter غير معين أو فارغاً، يُخصص توسيع word لـ parameter، ويكون التوسيع هو القيمة النهائية لـ parameter. لا يجوز تخصيص المعاملات الموضعية والمعاملات الخاصة بهذه الطريقة.

${parameter:?word}

عرض خطأ إذا كان فارغاً أو غير معين. إذا كان parameter فارغاً أو غير معين، تكتب الصدفة توسيع word (أو رسالة بهذا المعنى إذا لم تكن word موجودة) إلى الخطأ القياسي، وإذا لم تكن تفاعلية، تخرج بحالة غير صفرية. لا تخرج الصدفة التفاعلية، ولكنها لا تنفذ الأمر المرتبط بالتوسيع. وإلا، تُستبدل قيمة parameter.

${parameter:+word}

استخدام قيمة بديلة. إذا كان parameter فارغاً أو غير معين، لا يُستبدل بشيء، وإلا يُستبدل بتوسيع word. لا تُستخدم قيمة parameter.

${parameter:offset}

${parameter:offset:length}

توسيع السلسلة الفرعية. يتوسع إلى ما يصل إلى length من محارف قيمة parameter بدءاً من المحرف المحدد بـ offset. إذا كان parameter هو @ أو *، أو مصفوفة مفهرسة بدليل @ أو *، أو اسم مصفوفة ترابطية، تختلف النتائج كما هو موضح أدناه. إذا حُذف :length (الشكل الأول أعلاه)، فإن هذا يتوسع إلى السلسلة الفرعية لقيمة parameter بدءاً من المحرف المحدد بـ offset ويمتد إلى نهاية القيمة. إذا حُذف offset، يُعامل كـ 0. إذا حُذف length، ولكن النقطتين بعد offset موجودتان، يُعامل كـ 0. length و offset هما تعبيران حسابيان (انظر ARITHMETIC EVALUATION أدناه).

إذا أدى تقييم offset إلى رقم أقل من الصفر، تُستخدم القيمة كإزاحة بالمحارف من نهاية قيمة parameter. إذا أدى تقييم length إلى رقم أقل من الصفر، فإنه يُفسر كإزاحة بالمحارف من نهاية قيمة parameter بدلاً من عدد من المحارف، ويكون التوسيع هو المحارف بين offset وتلك النتيجة. لاحظ أنه يجب فصل الإزاحة السالبة عن النقطتين بمسافة واحدة على الأقل لتجنب الالتباس مع توسيع :-.

إذا كان parameter هو @ أو *، تكون النتيجة هي length من المعاملات الموضعية بدءاً من offset. تؤخذ الإزاحة السالبة offset نسبةً لواحد أكبر من أكبر معامل موضعي، لذا فإن إزاحة -1 تُقيم إلى آخر معامل موضعي (أو 0 إذا لم تكن هناك معاملات موضعية). يعتبر خطأ توسيع إذا أدى تقييم length إلى رقم أقل من الصفر.

إذا كان parameter اسم مصفوفة مفهرسة بدليل @ أو *، تكون النتيجة هي length من أعضاء المصفوفة بدءاً من ${parameter[offset]}. تؤخذ الإزاحة السالبة offset نسبةً لواحد أكبر من الفهرس الأقصى للمصفوفة المحددة. يعتبر خطأ توسيع إذا أدى تقييم length إلى رقم أقل من الصفر.

يؤدي توسيع السلسلة الفرعية المطبق على مصفوفة ترابطية إلى نتائج غير محددة.

تعتمد فهرسة السلسلة الفرعية على الصفر ما لم تُستخدم المعاملات الموضعية، وفي هذه الحالة تبدأ الفهرسة من 1 مبدئياً. إذا كان offset هو 0، واستُخدمت المعاملات الموضعية، تُسبق القائمة بـ $0.

${!prefix*}

${!prefix@}

الأسماء المطابقة للسابقة. يتوسع إلى أسماء المتغيرات التي تبدأ أسماؤها بـ prefix، مفصولة بالمحرف الأول من متغير IFS الخاص. عند استخدام @ وظهور التوسيع داخل اقتباس مزدوج، يتوسع كل اسم متغير إلى كلمة منفصلة.

${!name[@]}

${!name[*]}

قائمة مفاتيح المصفوفة. إذا كان name متغير مصفوفة، يتوسع إلى قائمة فهارس (مفاتيح) المصفوفة المخصصة في name. إذا لم يكن name مصفوفة، يتوسع إلى 0 إذا كان name معيناً وإلى فارغ خلاف ذلك. عند استخدام @ وظهور التوسيع داخل اقتباس مزدوج، يتوسع كل مفتاح إلى كلمة منفصلة.

${#parameter}

طول المعامل. يستبدل الطول بالمحارف للقيمة الموسعة لـ parameter. إذا كان parameter هو * أو @، تكون القيمة المستبدلة هي عدد المعاملات الموضعية. إذا كان parameter اسم مصفوفة بدليل * أو @، تكون القيمة المستبدلة هي عدد العناصر في المصفوفة. إذا كان parameter اسم مصفوفة مفهرسة متبوعاً بدليل سالب، يُفسر هذا الرقم كقيمة نسبية لواحد أكبر من الفهرس الأقصى لـ parameter، لذا فإن الفهارس السالبة تعد تنازلياً من نهاية المصفوفة، ويشير الفهرس -1 إلى العنصر الأخير.

${parameter#word}

${parameter##word}

إزالة نمط السابقة المطابق. تُوسع word لإنتاج نمط كما هو الحال في توسيع مسار الاسم، وتُطابق مع القيمة الموسعة لـ parameter باستخدام القواعد الموضحة تحت Pattern Matching أدناه. إذا طابق النمط بداية قيمة parameter، فإن نتيجة التوسيع هي القيمة الموسعة لـ parameter مع حذف أقصر نمط مطابق (حالة “#” ) أو أطول نمط مطابق (حالة “##” ). إذا كان parameter هو @ أو *، تُطبق عملية إزالة النمط على كل معامل موضعي بالدور، ويكون التوسيع هو القائمة الناتجة. إذا كان parameter متغير مصفوفة بدليل @ أو *، تُطبق عملية إزالة النمط على كل عضو في المصفوفة بالدور، ويكون التوسيع هو القائمة الناتجة.

${parameter%word}

${parameter%%word}

إزالة نمط اللاحقة المطابق. تُوسع word لإنتاج نمط كما هو الحال في توسيع مسار الاسم، وتُطابق مع القيمة الموسعة لـ parameter باستخدام القواعد الموضحة تحت Pattern Matching أدناه. إذا طابق النمط جزءاً لاحقاً من القيمة الموسعة لـ parameter، فإن نتيجة التوسيع هي القيمة الموسعة لـ parameter مع حذف أقصر نمط مطابق (حالة “%” ) أو أطول نمط مطابق (حالة “%%” ). إذا كان parameter هو @ أو *، تُطبق عملية إزالة النمط على كل معامل موضعي بالدور، ويكون التوسيع هو القائمة الناتجة. إذا كان parameter متغير مصفوفة بدليل @ أو *، تُطبق عملية إزالة النمط على كل عضو في المصفوفة بالدور، ويكون التوسيع هو القائمة الناتجة.

${parameter/pattern/string}

${parameter//pattern/string}

${parameter/#pattern/string}

${parameter/%pattern/string}

استبدال النمط. يُوسع pattern لإنتاج نمط ويُطابق مع القيمة الموسعة لـ parameter كما هو موضح تحت Pattern Matching أدناه. يُستبدل أطول تطابق لـ pattern في القيمة الموسعة بـ string. تخضع string لتوسيع المد، وتوسيع المعاملات والمتغيرات، والتوسيع الحسابي، واستبدال الأوامر والعمليات، وإزالة الاقتباس.

في الشكل الأول أعلاه، يُستبدل التطابق الأول فقط. إذا كان هناك شرطتان مائلتان تفصلان parameter و pattern (الشكل الثاني أعلاه)، تُستبدل جميع تطابقات pattern بـ string. إذا كان pattern مسبوقاً بـ # (الشكل الثالث أعلاه)، يجب أن يطابق بداية القيمة الموسعة لـ parameter. إذا كان pattern مسبوقاً بـ % (الشكل الرابع أعلاه)، يجب أن يطابق نهاية القيمة الموسعة لـ parameter.

إذا كان توسيع string فارغاً، تُحذف تطابقات pattern ويمكن حذف / التي تلي pattern.

إذا فُعّل خيار الصدفة patsub_replacement باستخدام shopt، تُستبدل أي مثيلات غير مقتبسة من & في string بالجزء المطابق من pattern.

يمنع اقتباس أي جزء من string الاستبدال في توسيع الجزء المقتبس، بما في ذلك سلاسل الاستبدال المخزنة في متغيرات الصدفة. تهرب الشرطة المائلة الخلفية & في string؛ وتُزال الشرطة المائلة الخلفية للسماح بوجود & حرفي في سلسلة الاستبدال. يمكن أيضاً استخدام الشرطة المائلة الخلفية لهروب شرطة مائلة خلفية؛ تؤدي \\ إلى شرطة مائلة خلفية حرفية في الاستبدال. يجب على المستخدمين توخي الحذر إذا كانت string داخل اقتباس مزدوج لتجنب التفاعلات غير المرغوب فيها بين الشرطة المائلة الخلفية والاقتباس المزدوج، حيث أن للشرطة المائلة الخلفية معنى خاصاً داخل الاقتباس المزدوج. يجري استبدال النمط فحصاً لـ & غير المقتبسة بعد توسيع string؛ يجب على مبرمجي الصدفة اقتباس أي ظهور لـ & يريدون أخذه حرفياً في الاستبدال والتأكد من أن أي مثيلات لـ & يريدون استبدالها غير مقتبسة.

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

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

إذا كان parameter هو @ أو *، فستُطبَّق عملية الاستبدال على كل معامل موضعي بالترتيب، ويكون التوسع هو القائمة الناتجة. وإذا كان parameter متغير مصفوفة مفهرسًا بـ @ أو *، فستُطبَّق عملية الاستبدال على كل عنصر في المصفوفة بالترتيب، ويكون التوسع هو القائمة الناتجة.

${parameter^pattern}

${parameter^^pattern}

${parameter,pattern}

${parameter,,pattern}

تعديل حالة الأحرف. يُعدل هذا التوسع حالة الأحرف الأبجدية في parameter. أولاً، يُوسع pattern لإنتاج نمط كما هو موضح أدناه في قسم مطابقة الأنماط. ثم تفحص صدفة Bash الأحرف في القيمة الموسعة لـ parameter مقابل pattern كما هو موضح أدناه. فإذا طابق حرف ما النمط، تُحوَّل حالته. يجب ألا يحاول النمط مطابقة أكثر من حرف واحد.

استخدام “^” يُحوِّل الأحرف الصغيرة التي تطابق pattern إلى أحرف كبيرة؛ “,” يُحوِّل الأحرف الكبيرة المطابقة إلى أحرف صغيرة. تفحص المتغيرات ^ و , الحرف الأول في القيمة الموسعة وتُحوِّل حالته إذا طابق pattern؛ بينما تفحص المتغيرات ^^ و ,, جميع الأحرف في القيمة الموسعة وتُحوِّل كل حرف يطابق pattern. إذا حُذف pattern، فإنه يُعامل مثل ?، الذي يطابق كل حرف.

إذا كان parameter هو @ أو *، فستُطبَّق عملية تعديل الحالة على كل معامل موضعي بالترتيب، ويكون التوسع هو القائمة الناتجة. وإذا كان parameter متغير مصفوفة مفهرسًا بـ @ أو *، فستُطبَّق عملية تعديل الحالة على كل عنصر في المصفوفة بالترتيب، ويكون التوسع هو القائمة الناتجة.

${parameter@operator}

تحويل المعاملات. يكون التوسع إما تحويلًا لقيمة parameter أو معلومات حول parameter نفسه، اعتمادًا على قيمة operator. كل operator هو حرف واحد:

استبدال الأوامر¶

يسمح استبدال الأوامر لمخرجات أمر ما بأن تحل محل الأمر نفسه. هناك شكلان قياسيان:

تجري صدفة Bash التوسع عبر تنفيذ command في بيئة صدفة فرعية واستبدال عملية استبدال الأمر بالمخرجات القياسية للأمر، مع حذف أي أسطر جديدة لاحقة. لا تُحذف الأسطر الجديدة المضمنة، ولكن قد تُزال أثناء تقسيم الكلمات. يمكن استبدال عملية استبدال الأمر $(cat file) بالصيغة المكافئة والأسرع $(< file).

مع شكل الاقتباس الخلفي القديم للاستبدال، تحتفظ الشرطة المائلة العكسية بمعناها الحرفي إلا إذا تبعها $، أو `، أو \. أول اقتباس خلفي غير مسبوق بشرطة مائلة عكسية ينهي عملية استبدال الأمر. عند استخدام الصيغة $(command)، فإن كل الأحرف الموجودة بين القوسين تشكل الأمر؛ ولا يُعامل أي منها معاملة خاصة.

هناك شكل بديل لاستبدال الأوامر:

والذي ينفذ command في بيئة التنفيذ الحالية ويلتقط مخرجاته، مع إزالة الأسطر الجديدة اللاحقة مرة أخرى.

يجب أن يكون الحرف c الذي يلي قوس الفتح مسافة، أو علامة تبويب، أو سطرًا جديدًا، أو |، ويجب أن يكون قوس الإغلاق في موضع يمكن أن تظهر فيه كلمة محجوزة (أي مسبوقًا بمنهي أمر مثل الفاصلة المنقوطة). تسمح صدفة Bash لوصل قوس الإغلاق بالأحرف المتبقية في الكلمة دون الحاجة لتبعه بحرف ميتات صدفة كما تتطلب الكلمة المحجوزة عادةً.

تأخذ أي آثار جانبية لـ command مفعولها فورًا في بيئة التنفيذ الحالية وتستمر في البيئة الحالية بعد اكتمال الأمر (على سبيل المثال، مدمج exit يخرج من الصدفة).

يشبه هذا النوع من استبدال الأوامر سطحيًا تنفيذ وظيفة صدفة غير مسماة: تُنشأ المتغيرات المحلية كما يحدث عند تنفيذ وظيفة صدفة، ويجبر مدمج return الأمر command على الاكتمال؛ ومع ذلك، تتم مشاركة بقية بيئة التنفيذ، بما في ذلك المعاملات الموضعية، مع المستدعِي.

إذا كان الحرف الأول بعد قوس الفتح هو |، فإن البنية تتوسع إلى قيمة متغير الصدفة REPLY بعد تنفيذ command، دون إزالة أي أسطر جديدة لاحقة، وتظل المخرجات القياسية لـ command كما هي في الصدفة المستدعِية. تنشئ Bash REPLY كمتغير محلي غير مضبوط في البداية عند تنفيذ command، وتستعيد قيمة REPLY التي كانت لديه قبل استبدال الأمر بعد اكتمال command، كما هو الحال مع أي متغير محلي.

يمكن أن تكون عمليات استبدال الأوامر متداخلة. للقيام بالتداخل عند استخدام شكل الاقتباس الخلفي، يجب الهروب من الاقتباسات الخلفية الداخلية باستخدام شرطات مائلة عكسية.

إذا ظهر الاستبدال داخل علامتي اقتباس مزدوجتين، فلن تقوم صدفة bash بتقسيم الكلمات وتوسيع مسار الملف على النتائج.

التوسع الحسابي¶

يقيّم التوسع الحسابي تعبيرًا حسابيًا ويستبدله بالنتيجة. صيغة التوسع الحسابي هي:

التنسيق القديم $[تعبير] مهجور وسيُزال في الإصدارات القادمة من bash.

يخضع expression لنفس التوسعات كما لو كان داخل علامتي اقتباس مزدوجتين، لكن أحرف الاقتباس المزدوجة غير المهربة في expression لا تُعامل معاملة خاصة وتُزال. تخضع جميع الرموز في التعبير لتوسع المعاملات والمتغيرات، واستبدال الأوامر، وإزالة الاقتباس. تُعامل النتيجة كتعبير حسابي يجب تقييمه. وبما أن الطريقة التي تتعامل بها صدفة Bash مع الاقتباسات المزدوجة يمكن أن تؤدي إلى سلاسل فارغة، فإن التوسع الحسابي يعاملها كتعبيرات تُقيّم بـ 0. يمكن أن تكون التوسعات الحسابية متداخلة.

يُجرى التقييم وفقًا للقواعد المدرجة أدناه في قسم التقييم الحسابي. إذا كان expression غير صالح، تطبع bash رسالة إلى الخطأ القياسي تشير إلى الفشل، ولا تقوم بالاستبدال، ولا تنفذ الأمر المرتبط بالتوسع.

استبدال العمليات¶

يسمح استبدال العمليات بالإشارة إلى مدخلات أو مخرجات عملية ما باستخدام اسم ملف. يأخذ شكل <(list) أو >(list). تُشغّل قائمة العمليات list بشكل غير متزامن، وتظهر مدخلاتها أو مخرجاتها كاسم ملف. يُمرر اسم الملف هذا كوسيط للأمر الحالي كنتيجة للتوسع.

إذا استُخدمت صيغة >(list)، فإن الكتابة إلى الملف توفر مدخلات لـ list. وإذا استُخدمت صيغة <(list)، فإن قراءة الملف تجلب مخرجات list. يجب ألا تظهر أي مسافة بين < أو > والقوس الأيسر، وإلا فسيُفسر البناء على أنه إعادة توجيه.

يُدعم استبدال العمليات في الأنظمة التي تدعم الأنابيب المسماة (FIFOs) أو طريقة /dev/fd لتسمية الملفات المفتوحة.

عند توفره، يُجرى استبدال العمليات بالتزامن مع توسع المعاملات والمتغيرات، واستبدال الأوامر، والتوسع الحسابي.

تقسيم الكلمات¶

تمسح الصدفة نتائج توسع المعاملات، واستبدال الأوامر، والتوسع الحسابي التي لم تحدث داخل علامتي اقتباس مزدوجتين لغرض تقسيم الكلمات. لا تُقسم الكلمات التي لم تُوسع.

تعامل الصدفة كل حرف في IFS كمحدد، وتقسم نتائج التوسعات الأخرى إلى كلمات باستخدام هذه الأحرف كمنهيات للحقول.

حرف مسافة IFS البيضاء هو مسافة بيضاء كما هي محددة أعلاه (انظر التعاريف) والتي تظهر في قيمة IFS. تُعتبر المسافة، وعلامة التبويب، والسطر الجديد دائمًا مسافات IFS بيضاء، حتى لو لم تظهر في فئة space الخاصة بالمحلية.

إذا كان IFS غير مضبوط، فإن تقسيم الحقول يعمل كما لو كانت قيمته هي <مسافة><تبويب><سطر_جديد>، ويعامل هذه الأحرف كمسافات IFS بيضاء. إذا كانت قيمة IFS فارغة (null)، فلا يحدث تقسيم للكلمات، ولكن لا تزال وسائط null الضمنية (انظر أدناه) تُزال.

يبدأ تقسيم الكلمات بإزالة تسلسلات أحرف مسافة IFS البيضاء من بداية ونهاية نتائج التوسعات السابقة، ثم يُقسم الكلمات المتبقية.

إذا كانت قيمة IFS تتكون فقط من مسافات IFS بيضاء، فإن أي تسلسل من أحرف مسافة IFS البيضاء يحدد حقلًا، لذا يتكون الحقل من أحرف ليست مسافات IFS بيضاء غير مقتبسة، وتنتج الحقول الفارغة فقط من الاقتباس.

إذا احتوى IFS على حرف ليس مسافة بيضاء، فإن أي حرف في قيمة IFS ليس مسافة IFS بيضاء، مع أي أحرف مسافة IFS بيضاء مجاورة، يحدد حقلًا. وهذا يعني أن المحددات المتجاورة التي ليست مسافات IFS بيضاء تنتج حقلًا فارغًا. كما يحدد تسلسل أحرف مسافة IFS البيضاء حقلًا أيضًا.

يُحتفظ بالوسائط الفارغة (null) الصريحة ("" أو '') وتُمرر إلى الأوامر كسلاسل نصية فارغة. أما الوسائط الفارغة الضمنية غير المقتبسة، الناتجة عن توسع المعاملات التي لا تملك قيمًا، فتُزال. إن توسيع معامل ليس له قيمة داخل علامتي اقتباس مزدوجتين ينتج حقلًا فارغًا، والذي يُحتفظ به ويُمرر إلى الأمر كسلسلة نصية فارغة.

عندما يظهر وسيط فارغ مقتبس كجزء من كلمة يكون توسعها غير فارغ، فإن تقسيم الكلمات يزيل جزء الوسيط الفارغ، تاركًا التوسع غير الفارغ. أي أن الكلمة “-d''” يصبح “-d” بعد تقسيم الكلمات وإزالة الوسائط الفارغة.

توسع مسار الملف¶

بعد تقسيم الكلمات، وما لم يُضبط الخيار -f، تمسح صدفة bash كل كلمة بحثًا عن الأحرف * و ? و [. إذا ظهر أحد هذه الأحرف، ولم يكن مقتبسًا، تُعتبر الكلمة حينئذٍ نمطًا، وتُستبدل بقائمة مرتبة من أسماء الملفات التي تطابق النمط (انظر مطابقة الأنماط أدناه) مع مراعاة قيمة متغير الصدفة GLOBSORT.

إذا لم يُعثر على أسماء ملفات مطابقة، ولم يكن خيار الصدفة nullglob مُمكناً، تُترك الكلمة دون تغيير. إذا ضُبط خيار nullglob، ولم يُعثر على تطابقات، تُزال الكلمة. إذا ضُبط خيار الصدفة failglob، ولم يُعثر على تطابقات، يطبع bash رسالة خطأ ولا ينفذ الأمر. إذا مُكّن خيار الصدفة nocaseglob، تُجرى المطابقة دون مراعاة حالة الأحرف الأبجدية. لاحظ أنه عند استخدام تعبيرات النطاق مثل [a-z] (انظر أدناه)، قد تُدرج أحرف من الحالة الأخرى، اعتماداً على إعداد LC_COLLATE.

عند استخدام نمط لتوسيع مسار الملف، فإن الحرف “.” في بداية الاسم أو بعد شرطة مائلة مباشرة يجب مطابقته صراحة، ما لم يكن خيار الصدفة dotglob مضبوطًا. لمطابقة أسماء الملفات . و .., يجب أن يبدأ النمط بـ “.” (على سبيل المثال، “.?”), حتى لو كان dotglob مضبوطًا. إذا كان خيار الصدفة globskipdots مفعلاً، فإن أسماء الملفات . و .. لا تطابق أبدًا، حتى لو بدأ النمط بـ “.”. عند عدم مطابقة مسارات الملفات، فإن الحرف “.” لا يُعامل معاملة خاصة.

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

انظر وصف shopt أدناه في قسم أوامر الصدفة المدمجة للاطلاع على وصف لخيارات الصدفة nocaseglob و nullglob و globskipdots و failglob و dotglob.

يمكن استخدام متغير الصدفة GLOBIGNORE لتقييد مجموعة أسماء الملفات التي تطابق نمطًا ما. إذا ضُبط GLOBIGNORE، فسيُزال كل اسم ملف مطابق يطابق أيضًا أحد الأنماط في GLOBIGNORE من قائمة المطابقات. وإذا ضُبط خيار nocaseglob، تُجرى المطابقة ضد الأنماط في GLOBIGNORE دون مراعاة حالة الأحرف. أسماء الملفات . و .. يتم تجاهلها دائمًا عندما يكون GLOBIGNORE مضبوطًا وغير فارغ. ومع ذلك، فإن ضبط GLOBIGNORE لقيمة غير فارغة يؤدي إلى تفعيل خيار الصدفة dotglob، لذا فإن جميع أسماء الملفات الأخرى التي تبدأ بـ “.” تطابق. وللحصول على السلوك القديم بتجاهل أسماء الملفات التي تبدأ بـ “.”, اجعل “.*” أحد الأنماط في GLOBIGNORE. يُعطل الخيار dotglob عندما يكون GLOBIGNORE غير مضبوط. تراعي مطابقة أنماط GLOBIGNORE إعداد خيار الصدفة extglob.

تتحكم قيمة متغير الصدفة GLOBSORT في كيفية فرز نتائج توسيع مسار الملف، كما هو موضح أعلاه في قسم متغيرات الصدفة.

مطابقة الأنماط

أي حرف يظهر في النمط، بخلاف أحرف الأنماط الخاصة الموضحة أدناه، يطابق نفسه. لا يجوز أن يظهر حرف NUL في النمط. تهرب الشرطة المائلة العكسية الحرف التالي لها؛ وتُهمل الشرطة المائلة المهربة عند المطابقة. يجب اقتباس أحرف الأنماط الخاصة إذا أريد مطابقتها حرفيًا.

لأحرف الأنماط الخاصة المعاني التالية:

إذا فُعّل خيار الصدفة extglob باستخدام المدمج shopt، ستتعرف الصدفة على عدة معاملات موسعة لمطابقة الأنماط. في الوصف التالي، pattern-list هي قائمة من نمط واحد أو أكثر مفصولة بـ |. يمكن تكوين أنماط مركبة باستخدام واحد أو أكثر من الأنماط الفرعية التالية:

يغير خيار extglob سلوك المحلل، لأن الأقواس تُعامل عادةً كمعاملات ذات معنى نحوي. لضمان تحليل أنماط المطابقة الموسعة بشكل صحيح، تأكد من تفعيل extglob قبل تحليل الأبنية التي تحتوي على الأنماط، بما في ذلك وظائف الصدفة واستبدالات الأوامر.

عند مطابقة أسماء الملفات، يحدد خيار الصدفة dotglob مجموعة أسماء الملفات التي تُختبر: فعند تفعيل dotglob، تتضمن مجموعة أسماء الملفات جميع الملفات التي تبدأ بـ “.”, ولكن . و .. يجب مطابقتها بنمط أو نمط فرعي يبدأ بنقطة؛ وعند تعطيله، لا تتضمن المجموعة أي أسماء ملفات تبدأ بـ “.” ما لم يبدأ النمط أو النمط الفرعي بـ “.”. إذا كان خيار الصدفة globskipdots مفعلاً، فإن أسماء الملفات . و .. لا تظهر أبدًا في المجموعة. وكما ذكر أعلاه، فإن “.” لها معنى خاص فقط عند مطابقة أسماء الملفات.

تكون مطابقة الأنماط الموسعة المعقدة مقابل السلاسل الطويلة بطيئة، خاصةً عندما تحتوي الأنماط على تبادلات والسلاسل على مطابقات متعددة. قد يكون استخدام مطابقات منفصلة مقابل سلاسل أقصر، أو استخدام مصفوفات من السلاسل بدلاً من سلسلة طويلة واحدة، أسرع.

إزالة الاقتباس¶

بعد التوسعات السابقة، تُزال جميع حالات الظهور غير المقتبسة للأحرف \ و ' و " التي لم تنتج عن إحدى التوسعات المذكورة أعلاه.

إعادة توجيه المدخلات¶

إعادة توجيه المدخلات تفتح الملف الذي ينتج اسمه عن توسع word للقراءة على واصف الملف n، أو المدخلات القياسية (واصف الملف 0) إذا لم يُحدد n.

الصيغة العامة لإعادة توجيه المدخلات هي:

إعادة توجيه المخرجات¶

إعادة توجيه المخرجات تفتح الملف الذي ينتج اسمه عن توسع word للكتابة على واصف الملف n، أو المخرجات القياسية (واصف الملف 1) إذا لم يُحدد n. إذا لم يكن الملف موجودًا فسيُنشأ؛ وإذا كان موجودًا فسيُقص إلى حجم صفر.

الصيغة العامة لإعادة توجيه المخرجات هي:

إذا كان معامل إعادة التوجيه هو >، وفُعّل الخيار noclobber للأمر المدمج set، فستفشل إعادة التوجيه إذا كان الملف الذي ينتج اسمه عن توسع word موجودًا وكان ملفًا عاديًا. أما إذا كان معامل إعادة التوجيه هو >|، أو كان المعامل هو > وكان الخيار noclobber للأمر المدمج set غير مفعل، فستحاول bash إجراء إعادة التوجيه حتى لو كان الملف المسمى بـ word موجودًا.

إلحاق المخرجات الموجهة¶

إعادة توجيه المخرجات بهذه الطريقة تفتح الملف الذي ينتج اسمه عن توسع word للإلحاق على واصف الملف n، أو المخرجات القياسية (واصف الملف 1) إذا لم يُحدد n. وإذا لم يكن الملف موجودًا فسيُنشأ.

الصيغة العامة لإلحاق المخرجات هي:

إعادة توجيه المخرجات القياسية والخطأ القياسي¶

تُعيد هذه البنية توجيه كل من المخرج القياسي (واصف الملف 1) ومخرج الخطأ القياسي (واصف الملف 2) إلى الملف الذي يكون اسمه هو توسيع word.

هناك تنسيقان لإعادة توجيه المخرج القياسي والخطأ القياسي:

يُفضل الشكل الأول من بين الشكلين. وهذا يعادل دلاليًا

عند استخدام الشكل الثاني، قد لا يتوسع word إلى رقم أو -. إذا حدث ذلك، تُطبق معاملات إعادة توجيه أخرى (انظر Duplicating File Descriptors أدناه) لأسباب تتعلق بالتوافق.

إلحاق المخرج القياسي والخطأ القياسي¶

تُلحق هذه البنية كل من المخرج القياسي (واصف الملف 1) ومخرج الخطأ القياسي (واصف الملف 2) بالملف الذي يكون اسمه هو توسيع word.

تنسيق إلحاق المخرج القياسي والخطأ القياسي هو:

وهذا يعادل دلاليًا

(انظر Duplicating File Descriptors أدناه).

مستندات "هنا" (Here Documents)¶

يوجه هذا النوع من إعادة التوجيه الـ صدفة لقراءة المدخلات من المصدر الحالي حتى تقرأ سطرًا يحتوي فقط على delimiter (بدون فراغات لاحقة). تصبح جميع الأسطر المقروءة حتى تلك النقطة هي المدخل القياسي (أو واصف الملف n إذا حُدد n) لأمر ما.

تنسيق مستندات "هنا" هو:

[n]<<[-]word


        here-document
delimiter

لا تقوم الـ صدفة بإجراء توسيع للمعاملات والمتغيرات، أو استبدال للأوامر، أو توسيع حسابي، أو توسيع لمسار الملف على word.

إذا كان أي جزء من word مقتبسًا، فإن الـ delimiter يكون نتيجة إزالة الاقتباس من word، ولا يتم توسيع الأسطر في مستند "هنا". أما إذا كان word غير مقتبس، فإن الـ delimiter يكون هو word نفسها، ويُعامل نص مستند "هنا" بشكل مشابه لسلسلة مقتبسة اقتباسًا مزدوجًا: تخضع جميع أسطر مستند "هنا" لتوسيع المعاملات، واستبدال الأوامر، والتوسيع الحسابي، وتُعامل متوالية المحارف \<newline> حرفيًا، ويجب استخدام \ لاقتباس المحارف \ و $ و `؛ ومع ذلك، لا يكون لمحارف الاقتباس المزدوج أي معنى خاص.

إذا كان معامل إعادة التوجيه هو <<-، فإن الـ صدفة تجرد جميع محارف علامة التبويب البادئة من أسطر الإدخال ومن السطر الذي يحتوي على delimiter. يتيح هذا لمحارف مستندات "هنا" داخل سكريبتات الـ صدفة أن تُزاح بمسافة بادئة بشكل طبيعي.

إذا لم يكن المحدد مقتبسًا، تُعامل متوالية \<newline> كاتصال للسطر: يُضم السطران ويُزال الخط المائل العكسي والسطر الجديد. يحدث هذا أثناء قراءة مستند "هنا"، قبل التحقق من محدد النهاية، لذا يمكن للأسطر المضمومة أن تشكل محدد النهاية.

سلاسل "هنا" (Here Strings)¶

متغير من مستندات "هنا"، وتنسيقه هو:

[n]<<<word

يخضع word لتوسيع التلدة (~)، وتوسيع المعاملات والمتغيرات، واستبدال الأوامر، والتوسيع الحسابي، وإزالة الاقتباس. لا يتم إجراء توسيع لمسار الملف أو تقسيم الكلمات. تُقدم النتيجة كسلسلة نصية واحدة، مع إلحاق سطر جديد، إلى الأمر في مدخله القياسي (أو واصف الملف n إذا حُدد n).

مضاعفة واصفات الملفات¶

معامل إعادة التوجيه

يُستخدم لمضاعفة واصفات ملفات الإدخال. إذا توسع word إلى رقم واحد أو أكثر، يُجعل واصف الملف n نسخة من واصف الملف ذاك. يكون هناك خطأ في إعادة التوجيه إذا لم تحدد الأرقام في word واصف ملف مفتوح للإدخال. إذا كانت قيمة word هي -، يُغلق واصف الملف n. إذا لم يُحدد n، فسيستخدم هذا المدخل القياسي (واصف الملف 0).

المعامل

يُستخدم بشكل مشابه لمضاعفة واصفات ملفات الإخراج. إذا لم يُحدد n، فسيستخدم هذا المخرج القياسي (واصف الملف 1). يكون هناك خطأ في إعادة التوجيه إذا لم تحدد الأرقام في word واصف ملف مفتوح للإخراج. إذا كانت قيمة word هي -، يُغلق واصف الملف n. كحالة خاصة، إذا حُذف n، ولم يتوسع word إلى رقم واحد أو أكثر أو -، فإن هذا يعيد توجيه المخرج القياسي والخطأ القياسي كما وُصف سابقًا.

نقل واصفات الملفات¶

معامل إعادة التوجيه

ينقل واصف الملف digit إلى واصف الملف n، أو المدخل القياسي (واصف الملف 0) إذا لم يُحدد n. يُغلق digit بعد مضاعفته إلى n.

وبالمثل، معامل إعادة التوجيه

ينقل واصف الملف digit إلى واصف الملف n، أو المخرج القياسي (واصف الملف 1) إذا لم يُحدد n.

فتح واصفات الملفات للقراءة والكتابة¶

معامل إعادة التوجيه

يفتح الملف الذي يكون اسمه هو توسيع word لكل من القراءة والكتابة على واصف الملف n، أو على واصف الملف 0 إذا لم يُحدد n. إذا لم يكن الملف موجودًا، فإنه يُنشأ.

تمثيل Readline¶

يستخدم هذا القسم مفاهيم التحرير بأسلوب Emacs وتمثيله لضربات المفاتيح. يُرمز لمفاتيح التحكم بـ C-key، فعلى سبيل المثال، C-n تعني Control-N. وبالمثل، يُرمز لمفاتيح meta بـ M-key، لذا M-x تعني Meta-X. غالبًا ما يُسمى مفتاح Meta بـ “Alt” أو “Option”.

في لوحات المفاتيح التي لا تحتوي على مفتاح Meta، تعني M-x الضغط على ESC x، أي اضغط ثم حرر مفتاح Escape، ثم اضغط وحرر مفتاح x، بالتسلسل. هذا يجعل ESC هو بادئة meta. والجمع M-C-x يعني ESC Control-x: اضغط ثم حرر مفتاح Escape، ثم اضغط مع الاستمرار على مفتاح Control أثناء الضغط على مفتاح x، ثم حررهما معًا.

في بعض لوحات المفاتيح، ينتج مغير مفتاح Meta محارف مع تعيين البت الثامن (0200). يمكنك استخدام المتغير enable-meta-key للتحكم في القيام بذلك من عدمه، إذا كانت لوحة المفاتيح تسمح بذلك. وفي كثير من الحالات الأخرى، تقوم الطرفية أو محاكي الطرفية بتحويل المفتاح المغير بـ meta إلى تسلسل مفاتيح يبدأ بـ ESC كما هو موضح في الفقرة السابقة.

إذا كان مفتاح Meta لديك ينتج تسلسل مفاتيح ببادئة ESC meta، يمكنك جعل ارتباطات المفاتيح M-key التي تحددها (انظر Readline Key Bindings أدناه) تقوم بنفس الشيء عن طريق ضبط المتغير force-meta-prefix.

يمكن إعطاء أوامر Readline وسائط رقمية، والتي تعمل عادةً كعداد تكرار. ومع ذلك، تكون إشارة الوسيط أحيانًا هي المؤثرة. تمرير وسيط سالب لأمر يعمل في الاتجاه الأمامي (مثل kill-line) يجعل ذلك الأمر يعمل في الاتجاه الخلفي. الأوامر التي ينحرف سلوكها مع الوسائط عن هذا موضحة أدناه.

تُسمى النقطة بموضع المؤشر الحالي، وتُشير العلامة إلى موضع مؤشر محفوظ. يُشار إلى النص بين النقطة والعلامة باسم المنطقة. لدى Readline مفهوم المنطقة النشطة: عندما تكون المنطقة نشطة، يقوم readline بإعادة العرض مع تمييز المنطقة باستخدام قيمة المتغير active-region-start-color. يقوم المتغير enable-active-region بتشغيل هذا أو إيقافه. تقوم أوامر عدة بضبط المنطقة لتكون نشطة؛ وتلك الأوامر موضحة أدناه.

عندما يوصف أمر بأنه يقوم بـ قتل نص، فإن النص المحذوف يُحفظ لاسترجاعه المحتمل مستقبلاً (النتر). يُحفظ النص المقتول في حلقة قتل. تجمع عمليات القتل المتتالية النص المحذوف في وحدة واحدة، والتي يمكن نترها دفعة واحدة. الأوامر التي لا تقتل النص تفصل بين كتل النص في حلقة القتل.

تهيِئة Readline¶

يُخصص Readline بوضع الأوامر في ملف تهيئة (ملف inputrc). يُؤخذ اسم هذا الملف من قيمة متغير الصدفة INPUTRC. إذا لم يُعين هذا المتغير، فإن القيمة المبدئية هي ~/.inputrc. إذا كان ذلك الملف غير موجود أو لا يمكن قراءته، يبحث readline عن /etc/inputrc. عندما يبدأ برنامج يستخدم مكتبة readline، يقرأ readline ملف التهيئة ويضبط ارتباطات المفاتيح والمتغيرات الموجودة هناك، قبل قراءة أي مدخلات من المستخدم.

لا يُسمح إلا ببضعة تراكيب أساسية في ملف inputrc. تُتجاهل الأسطر الفارغة. الأسطر التي تبدأ بـ # هي تعليقات. الأسطر التي تبدأ بـ $ تشير إلى تراكيب شرطية. الأسطر الأخرى تدل على ارتباطات المفاتيح وإعدادات المتغيرات.

يمكن تغيير ارتباطات المفاتيح المبدئية في هذا القسم باستخدام أوامر ارتباط المفاتيح في ملف inputrc. البرامج التي تستخدم مكتبة readline، بما في ذلك bash، قد تضيف أوامرها وارتباطاتها الخاصة.

على سبيل المثال، وضع

داخل inputrc سيجعل M-C-u ينفذ أمر readline المسمى universal-argument.

قد تحتوي ارتباطات المفاتيح على أسماء المحارف الرمزية التالية: DEL، وESC، وESCAPE، وLFD، وNEWLINE، وRET، وRETURN، وRUBOUT (مفتاح رجوع حذف)، وSPACE، وSPC، وTAB.

بالإضافة إلى أسماء الأوامر، يسمح readline بربط المفاتيح بسلسلة نصوص تُدرج عند الضغط على المفتاح (macro). الفرق بين الماكرو والأمر هو أن الماكرو يكون محاطًا بعلامات اقتباس فردية أو مزدوجة.

ارتباطات مفاتيح Readline¶

بنية التحكم في ارتباطات المفاتيح في ملف inputrc بسيطة. كل ما هو مطلوب هو اسم الأمر أو نص الماكرو وتسلسل المفاتيح الذي يجب ربطه به. يمكن تحديد تسلسل المفاتيح بإحدى طريقتين: كاسم مفتاح رمزي، ربما مع بادئات Meta- أو Control-، أو كتسلسل مفاتيح يتكون من محرف واحد أو أكثر محاطة بعلامات اقتباس مزدوجة. يُفصل بين تسلسل المفاتيح والاسم بنقطتين. لا يمكن وجود مسافات بيضاء بين الاسم والنقطتين.

عند استخدام الصيغة keyname:function-name أو macro، فإن keyname هو اسم المفتاح مكتوبًا بالإنجليزية. على سبيل المثال:

Control-u: universal-argument
Meta-Rubout: backward-kill-word
Control-o: "> output"

في المثال أعلاه، رُبط C-u بالدالة universal-argument، ورُبط M-DEL بالدالة backward-kill-word، ورُبط C-o لتشغيل الماكرو المعبر عنه في الجانب الأيمن (أي لإدراج النص “> output” داخل السطر).

في الصيغة الثانية، "keyseq":function-name أو macro، يختلف keyseq عن keyname أعلاه في أنه يمكن تحديد سلاسل تدل على تسلسل مفاتيح كامل بوضع التسلسل داخل علامات اقتباس مزدوجة. يمكن استخدام بعض مهربات المفاتيح بأسلوب GNU Emacs، كما في المثال التالي، ولكن لا يتم التعرف على أي من أسماء المحارف الرمزية.

"\C-u": universal-argument
"\C-x\C-r": re-read-init-file
"\e[11~": "Function Key 1"

في هذا المثال، رُبط C-u مجددًا بالدالة universal-argument. ورُبط C-x C-r بالدالة re-read-init-file، ورُبط ESC [ 1 1 ~ لإدراج النص “Function Key 1”.

المجموعة الكاملة من تسلسلات الهروب بأسلوب GNU Emacs المتاحة عند تحديد تسلسلات المفاتيح هي

بالإضافة إلى تسلسلات الهروب بأسلوب GNU Emacs، تتوفر مجموعة ثانية من مهربات الشرطة المائلة العكسية:

عند إدخال نص الماكرو، يجب استخدام علامات اقتباس مفردة أو مزدوجة للإشارة إلى تعريف الماكرو. يُفترض أن النص غير المقتبس هو اسم دالة. تُوسّع مهربات الشرطة المائلة العكسية الموضحة أعلاه في متن الماكرو. تقوم الشرطة المائلة العكسية بإسكار أي محرف آخر في نص الماكرو، بما في ذلك " و '.

ستعرض Bash أو تعدل ارتباطات مفاتيح readline الحالية باستخدام الأمر المدمج bind. الخيارات -o emacs أو -o vi للأمر المدمج set (انظر SHELL BUILTIN COMMANDS أدناه) تغير وضع التحرير أثناء الاستخدام التفاعلي.

متغيرات Readline¶

لدى Readline متغيرات يمكن استخدامها لمزيد من تخصيص سلوكها. يمكن ضبط متغير في ملف inputrc بعبارة على الصيغة

باستثناء ما هو ملاحظ، يمكن لمتغيرات readline أن تأخذ القيم On أو Off (بغض النظر عن حالة الأحرف). تُتجاهل أسماء المتغيرات غير المعترف بها. عندما يقرأ readline قيمة متغير، فإن القيم الفارغة أو الصفرية، “on” (غير حساسة لحالة الأحرف)، و “1” تكافئ On. جميع القيم الأخرى تكافئ Off.

يسرد الأمر bind -V أسماء وقيم متغيرات readline الحالية (انظر SHELL BUILTIN COMMANDS أدناه).

المتغيرات وقيمها المبدئية هي:

active-region-start-color

متغير سلسلة نصية يتحكم في لون النص والخلفية عند عرض النص في المنطقة النشطة (انظر وصف enable-active-region أدناه). يجب ألا تشغل هذه السلسلة أي مواضع محارف فعلية على الشاشة، لذا يجب أن تتكون فقط من تسلسلات هروب الطرفية. تُخرّج إلى الطرفية قبل عرض النص في المنطقة النشطة. يُعاد تعيين هذا المتغير إلى القيمة المبدئية كلما تغير نوع الطرفية. القيمة المبدئية هي السلسلة التي تضع الطرفية في وضع البروز (standout)، كما هو مستمد من وصف terminfo الخاص بالطرفية. قد تكون القيمة النموذجية هي “\e[01;33m”.

active-region-end-color

متغير سلسلة نصية “undoes” تأثيرات active-region-start-color ويستعيد “normal” مظهر عرض الطرفية بعد عرض النص في المنطقة النشطة. يجب ألا تشغل هذه السلسلة أي مواضع محارف فعلية على الشاشة، لذا يجب أن تتكون فقط من تسلسلات هروب الطرفية. تُخرّج إلى الطرفية بعد عرض النص في المنطقة النشطة. يُعاد تعيين هذا المتغير إلى القيمة المبدئية كلما تغير نوع الطرفية. القيمة المبدئية هي السلسلة التي تستعيد الطرفية من وضع البروز (standout)، كما هو مستمد من وصف terminfo الخاص بالطرفية. قد تكون القيمة النموذجية هي “\e[0m”.

bell-style (audible)

يتحكم فيما يحدث عندما يريد readline رنين جرس الطرفية. إذا ضُبط على none، فلن يرن readline الجرس أبدًا. وإذا ضُبط على visible، سيستخدم readline جرسًا مرئيًا إذا كان متاحًا. وإذا ضُبط على audible، سيحاول readline رنين جرس الطرفية.

bind-tty-special-chars (On)

إذا ضُبط على On، سيحاول readline ربط محارف التحكم التي تُعامل بشكل خاص من قبل برنامج تشغيل طرفية النواة بمكافئاتها في readline. هذه الارتباطات تتجاوز ارتباطات readline المبدئية الموصوفة هنا. اكتب “stty -a” عند محث bash لرؤية إعدادات الطرفية الحالية، بما في ذلك محارف التحكم الخاصة (عادةً cchars).

blink-matching-paren (Off)

إذا ضُبط على On، سيحاول readline تحريك المؤشر لفترة وجيزة إلى قوس فتح عند إدراج قوس إغلاق.

colored-completion-prefix (Off)

إذا ضُبط على On، فعند سرد الإكمال، سيعرض readline البادئة المشتركة لمجموعة الإكمالات الممكنة باستخدام لون مختلف. تُؤخذ تعريفات الألوان من قيمة متغير البيئة LS_COLORS. إذا وجد تعريف لون في $LS_COLORS للاحقة المخصصة “.readline-colored-completion-prefix”, سيستخدم readline هذا اللون للبادئة المشتركة بدلاً من اللون المبدئي.

colored-stats (Off)

إذا ضُبط على On، سيعرض readline الإكمالات الممكنة باستخدام ألوان مختلفة للإشارة إلى نوع الملف. تُؤخذ تعريفات الألوان من قيمة متغير البيئة LS_COLORS.

comment-begin (

“#”) السلسلة التي يدرجها أمر insert-comment في readline. هذا الأمر مرتبط بـ M-# في وضع emacs وبالرمز # في وضع أوامر vi.

completion-display-width (-1)

عدد أعمدة الشاشة المستخدمة لعرض التطابقات الممكنة عند إجراء الإكمال. تُتجاهل القيمة إذا كانت أقل من 0 أو أكبر من عرض شاشة الطرفية. القيمة 0 تؤدي لعرض التطابقات واحداً في كل سطر. القيمة المبدئية هي -1.

completion-ignore-case (Off)

إذا ضُبط على On، سيقوم readline بمطابقة وإكمال أسماء الملفات بأسلوب غير حساس لحالة الأحرف.

completion-map-case (Off)

إذا ضُبط على On، وكان completion-ignore-case مفعلًا، سيعامل readline الشرطات (-) والشرطات السفلية (_) على أنها متكافئة عند إجراء مطابقة وإكمال أسماء الملفات بشكل غير حساس لحالة الأحرف.

completion-prefix-display-length (0)

الحد الأقصى لطول البادئة المشتركة (بالمحارف) لقائمة الإكمالات الممكنة التي تُعرض دون تعديل. عند ضبطها على قيمة أكبر من الصفر، يستبدل readline البادئات المشتركة الأطول من هذه القيمة بعلامة حذف (...) عند عرض الإكمالات الممكنة. إذا كان الإكمال يبدأ بنقطة، وكان readline يكمل أسماء الملفات، فإنه يستخدم ثلاث شرطات سفلية بدلاً من علامة الحذف.

completion-query-items (100)

يحدد هذا متى يُسأل المستخدم عن رغبته في عرض عدد الإكمالات الممكنة التي ولدها أمر possible-completions. يمكن ضبطه على أي قيمة صحيحة أكبر من أو تساوي الصفر. إذا كان عدد الإكمالات الممكنة أكبر من أو يساوي قيمة هذا المتغير، يسأل readline عما إذا كان المستخدم يرغب في عرضها أم لا؛ وإلا فإن readline يسردها ببساطة على الطرفية. القيمة صفر تعني ألا يسأل readline أبداً؛ وتُعامل القيم السالبة كصفر.

convert-meta (On)

إذا ضُبط على On، سيقوم readline بتحويل المحارف التي يقرؤها ولديها البت الثامن معينًا إلى تسلسل مفاتيح ASCII عن طريق مسح البت الثامن وإضافته كلاحقة لمحرف هروب (تحويل المحرف ليكون له بادئة meta). القيمة المبدئية هي On، ولكن readline يضبطها على Off إذا كانت الإعدادات المحلية تحتوي على محارف قد تتضمن ترميزاتها بايتات مع تعيين البت الثامن. يعتمد هذا المتغير على فئة الإعدادات المحلية LC_CTYPE، وقد يتغير إذا تغيرت الإعدادات المحلية. يؤثر هذا المتغير أيضاً على ارتباطات المفاتيح؛ انظر وصف force-meta-prefix أدناه.

disable-completion (Off)

إذا ضُبط على On، سيعطل readline إكمال الكلمات. ستُدرج محارف الإكمال في السطر كما لو كانت قد رُبطت بـ self-insert.

echo-control-characters (On)

عند ضبطه على On، في أنظمة التشغيل التي تشير إلى دعمها لذلك، سيقوم readline بترجيع محرف مقابل لإشارة تم توليدها من لوحة المفاتيح.

editing-mode (emacs)

يتحكم في ما إذا كان readline يستخدم مجموعة من ارتباطات المفاتيح تشبه Emacs أو vi. يمكن ضبط editing-mode على emacs أو vi.

emacs-mode-string (@)

إذا كان المتغير show-mode-in-prompt مفعلاً، فستُعرض هذه السلسلة مباشرةً قبل السطر الأخير من المحث الرئيس عندما يكون وضع تحرير emacs نشطاً. تُوسع القيمة مثل ارتباط مفاتيح، لذا تتوفر المجموعة القياسية من بادئات meta و control وتسلسلات هروب الشرطة المائلة العكسية. المهربات \1 و \2 تبدأ وتنهي تسلسلات من المحارف غير القابلة للطباعة، والتي يمكن استخدامها لدمج تسلسل تحكم للطرفية داخل سلسلة الوضع.

enable-active-region (On)

عند ضبط هذا المتغير على On، يسمح readline لأوامر معينة بتعيين المنطقة على أنها نشطة. عندما تكون المنطقة نشطة، يقوم readline بتمييز النص في المنطقة باستخدام قيمة المتغير active-region-start-color، والتي تكون مبدئياً هي السلسلة التي تفعل وضع البروز (standout) للطرفية. تعرض المنطقة النشطة النص المدرج بواسطة الإلصاق بين أقواس (bracketed-paste) وأي نص مطابق عُثر عليه بواسطة عمليات بحث التأريخ التزايدية وغير التزايدية.

enable-bracketed-paste (On)

عند ضبطه على On، يقوم readline بضبط الطرفية لإدراج كل عملية إلصاق في مخزن التحرير كسلسلة واحدة من المحارف، بدلاً من معاملة كل محرف وكأنه قُرئ من لوحة المفاتيح. يسمى هذا وضع الإلصاق بين أقواس؛ وهو يمنع readline من تنفيذ أي أوامر تحرير مرتبطة بتسلسلات مفاتيح تظهر في النص الملصق.

enable-keypad (Off)

عند ضبطه على On، يحاول readline تفعيل لوحة مفاتيح التطبيق عند استدعائه. تحتاج بعض الأنظمة لهذا لتفعيل مفاتيح الأسهم.

enable-meta-key (On)

عند ضبطه على On، يحاول readline تفعيل أي مفتاح مغير meta تدعي الطرفية دعمه. في كثير من الطرفيات، يُستخدم مفتاح Meta لإرسال محارف ذات ثمانية بتات؛ يتحقق هذا المتغير من قدرة الطرفية التي تشير إلى أن الطرفية يمكنها تفعيل وتعطيل وضع يضبط البت الثامن للمحرف (0200) إذا كان مفتاح Meta مضغوطاً عند كتابة المحرف (محرف meta).

expand-tilde (Off)

إذا ضُبط على On، سيقوم readline بإجراء توسيع التيلدا (~) عندما يحاول إكمال الكلمات.

force-meta-prefix (Off)

إذا ضُبط على On، فسيعدل readline سلوكه عند ربط تسلسلات المفاتيح التي تحتوي على \M- أو Meta- (انظر Key Bindings أعلاه) عن طريق تحويل تسلسل مفاتيح بالصيغة \M-C أو Meta-C إلى تسلسل من محرفين ESC C (إضافة بادئة meta). إذا ضُبط force-meta-prefix على Off (المبدئي)، فسيستخدم readline قيمة المتغير convert-meta لتحديد ما إذا كان سيقوم بهذا التحويل: إذا كان convert-meta هو On، سيقوم readline بالتحويل الموصوف أعلاه؛ وإذا كان Off، سيقوم readline بتحويل C إلى محرف meta عن طريق ضبط البت الثامن (0200).

history-preserve-point (Off)

إذا ضُبط على On، فسيحاول كود التأريخ وضع النقطة في نفس الموقع في كل سطر تأريخ يُسترجع باستخدام previous-history أو next-history.

history-size (unset)

يضبط الحد الأقصى لعدد مدخلات التأريخ المحفوظة في قائمة التأريخ. إذا ضُبط على الصفر، تُحذف أي مدخلات تأريخ موجودة ولا تُحفظ أي مدخلات جديدة. إذا ضُبط على قيمة أقل من الصفر، فلن يكون عدد مدخلات التأريخ محدوداً. بشكل مبدئي، تضبط bash الحد الأقصى لعدد مدخلات التأريخ وفقاً لقيمة متغير الصدفة HISTSIZE. سيؤدي ضبط history-size إلى قيمة غير رقمية لتعيين الحد الأقصى لعدد مدخلات التأريخ إلى 500.

horizontal-scroll-mode (Off)

ضبط هذا المتغير على On يجعل readline يستخدم سطراً واحداً للعرض، حيث يمرر المدخلات أفقياً على سطر شاشة واحد عندما تصبح أطول من عرض الشاشة بدلاً من الالتفاف إلى سطر جديد. يُفعل هذا الإعداد آلياً للطرفيات التي ارتفاعها 1.

input-meta (Off)

إذا ضُبط على On، سيقوم readline بتفعيل المدخلات ذات الثمانية بتات (أي أنه لا يمسح البت الثامن في المحارف التي يقرؤها)، بغض النظر عما تدعي الطرفية دعمه. القيمة المبدئية هي Off، ولكن readline يضبطها على On إذا كانت الإعدادات المحلية تحتوي على محارف قد تتضمن ترميزاتها بايتات مع تعيين البت الثامن. يعتمد هذا المتغير على فئة الإعدادات المحلية LC_CTYPE، وقد تتغير قيمته إذا تغيرت الإعدادات المحلية. الاسم meta-flag هو مرادف لـ input-meta.

isearch-terminators (

“C-[C-j”) سلسلة المحارف التي يجب أن تنهي البحث التزايدي دون تنفيذ المحرف كأمر لاحقاً. إذا لم تُعطَ قيمة لهذا المتغير، فإن المحرفين ESC و C-j ينهيان البحث التزايدي.

keymap (emacs)

يضبط خريطة مفاتيح readline الحالية. مجموعة أسماء خرائط المفاتيح الصالحة هي emacs, emacs-standard, emacs-meta, emacs-ctlx, vi, vi-command، و vi-insert. الخريطة vi تكافئ vi-command؛ و emacs تكافئ emacs-standard. القيمة المبدئية هي emacs؛ كما تؤثر قيمة editing-mode أيضاً على خريطة المفاتيح المبدئية.

keyseq-timeout (500)

يحدد المدة التي سينتظرها readline للحصول على محرف عند قراءة تسلسل مفاتيح غامض (تسلسل يمكن أن يشكل تسلسلاً كاملاً بالمدخلات المقروءة حتى الآن، أو يمكن أن يقبل مدخلات إضافية لإكمال تسلسل أطول). إذا لم يتلقَ readline أي مدخلات خلال مهلة الانتظار، فإنه يستخدم تسلسل المفاتيح الأقصر والأكمل. تُحدد القيمة بالمิลلي ثانية، لذا فإن القيمة 1000 تعني أن readline سينتظر ثانية واحدة لمدخلات إضافية. إذا ضُبط هذا المتغير على قيمة أقل من أو تساوي الصفر، أو على قيمة غير رقمية، فسينتظر readline حتى يُضغط على مفتاح آخر ليقرر أي تسلسل مفاتيح سيكمل.

mark-directories (On)

إذا ضُبط على On، فستُلحق شرطة مائلة بأسماء الأدلة المكتملة.

mark-modified-lines (Off)

إذا ضُبط على On، فسيعرض readline أسطر التأريخ التي عُدلت مسبوقة بعلامة النجمة (*).

mark-symlinked-directories (Off)

إذا ضُبط على On، فستُلحق شرطة مائلة بالأسماء المكتملة التي هي وصلات رمزية لأدلة، وذلك وفقاً لقيمة mark-directories.

match-hidden-files (On)

هذا المتغير، عند ضبطه على On، يجبر readline على مطابقة الملفات التي تبدأ أسماؤها بـ “.” (الملفات المخفية) عند إجراء إكمال أسماء الملفات. إذا ضُبط على Off، يجب على المستخدم تضمين علامة “.” البادئة في اسم الملف المراد إكماله.

menu-complete-display-prefix (Off)

إذا ضُبط على On، فسيقوم إكمال القائمة بعرض البادئة المشتركة لقائمة الإكمالات الممكنة (والتي قد تكون فارغة) قبل التنقل عبر القائمة.

output-meta (Off)

إذا ضُبط على On، سيقوم readline بعرض المحارف التي لديها البت الثامن معينًا بشكل مباشر بدلاً من عرضها كتسلسل هروب ببادئة meta. القيمة المبدئية هي Off، ولكن readline يضبطها على On إذا كانت الإعدادات المحلية تحتوي على محارف قد تتضمن ترميزاتها بايتات مع تعيين البت الثامن. يعتمد هذا المتغير على فئة الإعدادات المحلية LC_CTYPE، وقد تتغير قيمته إذا تغيرت الإعدادات المحلية.

page-completions (On)

إذا ضُبط على On، سيستخدم readline مستعرض صفحات داخلي يشبه more(1) لعرض ملء شاشة من الإكمالات الممكنة في كل مرة.

prefer-visible-bell

انظر bell-style.

print-completions-horizontally (Off)

إذا ضُبط على On، فسيقوم readline بعرض الإكمالات مع فرز التطابقات أفقياً بترتيب أبجدي، بدلاً من عرضها لأسفل الشاشة.

revert-all-at-newline (Off)

إذا ضُبط على On، ستتراجع مكتبة readline عن كل التغييرات في أسطر السجل قبل العودة عند تنفيذ accept-line. مبدئيًا، يمكن تعديل أسطر السجل والاحتفاظ بقوائم تراجع منفصلة عبر استدعاءات readline.

search-ignore-case (Off)

إذا ضُبط على On، تُجري readline عمليات البحث التزايدي وغير التزايدي في قائمة السجل بطريقة غير حساسة لحالة الأحرف.

show-all-if-ambiguous (Off)

يُغير هذا السلوك المبدئي لوظائف الإكمال. إذا ضُبط على On، فإن الكلمات التي لها أكثر من إكمال محتمل ستؤدي إلى إدراج المطابقات فورًا بدلاً من إطلاق صوت التنبيه.

show-all-if-unmodified (Off)

يُغير هذا السلوك المبدئي لوظائف الإكمال بطريقة مشابهة لـ show-all-if-ambiguous. إذا ضُبط على On، فإن الكلمات التي لها أكثر من إكمال محتمل دون أي إكمال جزئي ممكن (أي أن الإكمالات المحتملة لا تشترك في بادئة واحدة) ستؤدي إلى إدراج المطابقات فورًا بدلاً من إطلاق صوت التنبيه.

show-mode-in-prompt (Off)

إذا ضُبط على On، تُضاف سلسلة نصية إلى بداية المحث تشير إلى وضع التحرير: emacs، أو vi command، أو vi insertion. سلاسل الأوضاع قابلة للضبط من قبل المستخدم (مثل emacs-mode-string).

skip-completed-text (Off)

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

vi-cmd-mode-string ((cmd))

إذا فُعّل متغير show-mode-in-prompt، فستُعرض هذه السلسلة مباشرة قبل السطر الأخير من المحث الرئيس عندما يكون وضع تحرير vi نشطًا وفي وضع الأوامر. تُوسع القيمة مثل ارتباط مفاتيح، لذا تتوفر المجموعة القياسية من سوابق meta وcontrol وتسلسلات الهروب بالشرطة المائلة العكسية. يبدأ الهروبان \e1 و\e2 تسلسلات المحارف غير المطبوعة وينهيانها، والتي يمكن استخدامها لتضمين تسلسل تحكم للطرفية في سلسلة الوضع.

vi-ins-mode-string ((ins))

إذا فُعّل متغير show-mode-in-prompt، فستُعرض هذه السلسلة مباشرة قبل السطر الأخير من المحث الرئيس عندما يكون وضع تحرير vi نشطًا وفي وضع الإدراج. تُوسع القيمة مثل ارتباط مفاتيح، لذا تتوفر المجموعة القياسية من سوابق meta وcontrol وتسلسلات الهروب بالشرطة المائلة العكسية. يبدأ الهروبان \e1 و\e2 تسلسلات المحارف غير المطبوعة وينهيانها، والتي يمكن استخدامها لتضمين تسلسل تحكم للطرفية في سلسلة الوضع.

visible-stats (Off)

إذا ضُبط على On، سيُلحق محرف يشير إلى نوع الملف كما تُبلغ عنه stat(2) باسم الملف عند سرد الإكمالات المحتملة.

بنى Readline الشرطية¶

تنفذ Readline ميزة مشابهة في الروح لميزات التصريف الشرطي في معالج C المسبق والتي تسمح بإجراء ارتباطات المفاتيح وإعدادات المتغيرات كنتيجة للاختبارات. هناك أربعة توجيهات للمحلل متاحة.

$if

تسمح بنية $if بإجراء الارتباطات بناءً على وضع التحرير، أو الطرفية المستخدمة، أو التطبيق الذي يستخدم readline. يمتد نص الاختبار، بعد أي عامل مقارنة، إلى نهاية السطر؛ ما لم يذكر خلاف ذلك، لا توجد حاجة لمحارف لعزله.

$if Bash
# اقتباس الكلمة الحالية أو السابقة
"\C-xq": "\eb\"\ef\""
$endif

$else

تُنفذ الأوامر في هذا الفرع من توجيه $if إذا فشل الاختبار.

$endif

ينهي هذا الأمر، كما رأينا في المثال السابق، أمر $if.

$include

يأخذ هذا التوجيه اسم ملف واحد كمعامل ويقرأ الأوامر وارتباطات المفاتيح من ذلك الملف. على سبيل المثال، التوجيه التالي سيقرأ /etc/inputrc:

$include  /etc/inputrc

البحث¶

توفر Readline أوامر للبحث في سجل الأوامر (انظر HISTORY أدناه) عن أسطر تحتوي على سلسلة نصية محددة. هناك وضعان للبحث: تزايدي وغير تزايدي.

يبدأ البحث التزايدي قبل أن ينتهي المستخدم من كتابة سلسلة البحث. مع كتابة كل محرف من سلسلة البحث، تعرض readline المدخل التالي من السجل الذي يطابق السلسلة المكتوبة حتى الآن. يتطلب البحث التزايدي فقط عدد المحارف اللازم للعثور على مدخل السجل المطلوب. عند استخدام وضع تحرير emacs، اكتب C-r للبحث للخلف في السجل عن سلسلة نصية معينة. تؤدي كتابة C-s إلى البحث للأمام عبر السجل. تُستخدم المحارف الموجودة في قيمة متغير isearch-terminators لإنهاء البحث التزايدي. إذا لم يُعين لهذا المتغير قيمة، فإن مفتاحي ESC و C-j ينهيان البحث التزايدي. يجهض C-g البحث التزايدي ويعيد السطر الأصلي. عند إنهاء البحث، يصبح مدخل السجل الذي يحتوي على سلسلة البحث هو السطر الحالي.

للعثور على مدخلات مطابقة أخرى في قائمة السجل، اكتب C-r أو C-s حسب الاقتضاء. يبحث هذا للخلف أو للأمام في السجل عن المدخل التالي المطابق لسلسلة البحث المكتوبة حتى الآن. أي تسلسل مفاتيح آخر مرتبط بأمر readline ينهي البحث وينفذ ذلك الأمر. على سبيل المثال، ينهي السطر الجديد البحث ويقبل السطر، وبذلك ينفذ الأمر من قائمة السجل. سيؤدي أمر الحركة إلى إنهاء البحث، وجعل آخر سطر وُجد هو السطر الحالي، وبدء التحرير.

تتذكر Readline آخر سلسلة بحث تزايدي. إذا كُتب مفتاحا C-r مرتين دون وجود أي محارف متداخلة تحدد سلسلة بحث جديدة، فستستخدم readline أي سلسلة بحث متذكَّرة.

تقرأ عمليات البحث غير التزايدية سلسلة البحث كاملة قبل البدء في البحث عن مدخلات السجل المطابقة. يمكن أن يكتب المستخدم سلسلة البحث أو تكون جزءًا من محتويات السطر الحالي.

أسماء أوامر Readline¶

فيما يلي قائمة بأسماء الأوامر وتسلسلات المفاتيح المبدئية التي ترتبط بها. أسماء الأوامر التي لا يصاحبها تسلسل مفاتيح تكون غير مرتبطة مبدئيًا.

في الأوصاف التالية، تشير point إلى موضع المؤشر الحالي، وتشير mark إلى موضع مؤشر حُفظ بواسطة أمر set-mark. يُشار إلى النص بين النقطة والعلامة باسم المنطقة. لدى Readline مفهوم المنطقة النشطة: عندما تكون المنطقة نشطة، تُبرز إعادة عرض readline المنطقة باستخدام قيمة متغير active-region-start-color. يتحكم متغير enable-active-region في تشغيل ذلك وإيقافه. تضبط عدة أوامر المنطقة لتكون نشطة؛ ومذكورة أدناه.

أوامر الحركة¶

beginning-of-line (C-a)

الانتقال إلى بداية السطر الحالي. قد يرتبط هذا أيضًا بمفتاح Home في بعض لوحات المفاتيح.

end-of-line (C-e)

الانتقال إلى نهاية السطر. قد يرتبط هذا أيضًا بمفتاح End في بعض لوحات المفاتيح.

forward-char (C-f)

الانتقال محرفًا واحدًا للأمام. قد يرتبط هذا أيضًا بمفتاح السهم الأيمن في بعض لوحات المفاتيح.

backward-char (C-b)

الانتقال محرفًا واحدًا للخلف. قد يرتبط هذا أيضًا بمفتاح السهم الأيسر في بعض لوحات المفاتيح.

forward-word (M-f)

الانتقال للأمام إلى نهاية الكلمة التالية. تتكون الكلمات من محارف أبجدية رقمية (حروف وأرقام).

backward-word (M-b)

الانتقال للخلف إلى بداية الكلمة الحالية أو السابقة. تتكون الكلمات من محارف أبجدية رقمية (حروف وأرقام).

shell-forward-word (M-C-f)

الانتقال للأمام إلى نهاية الكلمة التالية. تُفصل الكلمات بواسطة محارف الصدفة الوصفية غير المقتبسة.

shell-backward-word (M-C-b)

الانتقال للخلف إلى بداية الكلمة الحالية أو السابقة. تُفصل الكلمات بواسطة محارف الصدفة الوصفية غير المقتبسة.

previous-screen-line

محاولة نقل النقطة إلى نفس عمود الشاشة الفعلي في سطر الشاشة الفعلي السابق. لن يحقق هذا التأثير المطلوب إذا كان سطر readline الحالي لا يشغل أكثر من سطر فعلي واحد أو إذا كانت النقطة لا تزيد عن طول المحث زائد عرض الشاشة.

next-screen-line

محاولة نقل النقطة إلى نفس عمود الشاشة الفعلي في سطر الشاشة الفعلي التالي. لن يحقق هذا التأثير المطلوب إذا كان سطر readline الحالي لا يشغل أكثر من سطر فعلي واحد أو إذا لم يكن طول سطر readline الحالي أكبر من طول المحث زائد عرض الشاشة.

clear-display (M-C-l)

مسح الشاشة، وإن أمكن، خبيئة التمرير الخلفي للطرفية، ثم إعادة رسم السطر الحالي، مع ترك السطر الحالي في أعلى الشاشة.

clear-screen (C-l)

مسح الشاشة، ثم إعادة رسم السطر الحالي، مع ترك السطر الحالي في أعلى الشاشة. باستخدام معامل عددي، سيُحدث السطر الحالي دون مسح الشاشة.

redraw-current-line

تحديث السطر الحالي.

أوامر التعامل مع السجل¶

accept-line (Newline, Return)

قبول السطر بغض النظر عن مكان المؤشر. إذا كان هذا السطر غير فارغ، فسيُضاف إلى قائمة السجل وفقًا لحالة متغيري HISTCONTROL و HISTIGNORE. إذا كان السطر سطر سجل معدلًا، فسيُستعاد سطر السجل إلى حالته الأصلية.

previous-history (C-p)

جلب الأمر السابق من قائمة السجل، بالتحرك للخلف في القائمة. قد يرتبط هذا أيضًا بمفتاح السهم العلوي في بعض لوحات المفاتيح.

next-history (C-n)

جلب الأمر التالي من قائمة السجل، بالتحرك للأمام في القائمة. قد يرتبط هذا أيضًا بمفتاح السهم السفلي في بعض لوحات المفاتيح.

beginning-of-history (M-<)

الانتقال إلى أول سطر في السجل.

end-of-history (M->)

الانتقال إلى نهاية سجل المدخلات، أي السطر الذي يجري إدخاله حاليًا.

operate-and-get-next (C-o)

قبول السطر الحالي للتنفيذ كما لو أُدخل سطر جديد، وجلب السطر التالي بالنسبة للسطر الحالي من السجل للتحرير. يحدد المعامل العددي، إذا قُدم، مدخل السجل الذي سيُستخدم بدلاً من السطر الحالي.

fetch-history

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

reverse-search-history (C-r)

البحث للخلف بدءًا من السطر الحالي والتحرك “up” عبر السجل حسب الضرورة. هذا بحث تزايدي. يضبط هذا الأمر المنطقة على النص المطابق ويفعل المنطقة.

forward-search-history (C-s)

البحث للأمام بدءًا من السطر الحالي والتحرك “down” عبر السجل حسب الضرورة. هذا بحث تزايدي. يضبط هذا الأمر المنطقة على النص المطابق ويفعل المنطقة.

non-incremental-reverse-search-history (M-p)

البحث للخلف عبر السجل بدءًا من السطر الحالي باستخدام بحث غير تزايدي عن سلسلة نصية يقدمها المستخدم. يمكن أن تطابق سلسلة البحث أي مكان في سطر السجل.

non-incremental-forward-search-history (M-n)

البحث للأمام عبر السجل باستخدام بحث غير تزايدي عن سلسلة نصية يقدمها المستخدم. يمكن أن تطابق سلسلة البحث أي مكان في سطر السجل.

history-search-backward

البحث للخلف عبر السجل عن سلسلة المحارف الموجودة بين بداية السطر الحالي والنقطة. يجب أن تطابق سلسلة البحث بداية سطر السجل. هذا بحث غير تزايدي. قد يرتبط هذا بمفتاح Page Up في بعض لوحات المفاتيح.

history-search-forward

البحث للأمام عبر السجل عن سلسلة المحارف الموجودة بين بداية السطر الحالي والنقطة. يجب أن تطابق سلسلة البحث بداية سطر السجل. هذا بحث غير تزايدي. قد يرتبط هذا بمفتاح Page Down في بعض لوحات المفاتيح.

history-substring-search-backward

البحث للخلف عبر السجل عن سلسلة المحارف الموجودة بين بداية السطر الحالي والنقطة. يمكن أن تطابق سلسلة البحث أي مكان في سطر السجل. هذا بحث غير تزايدي.

history-substring-search-forward

البحث للأمام عبر السجل عن سلسلة المحارف الموجودة بين بداية السطر الحالي والنقطة. يمكن أن تطابق سلسلة البحث أي مكان في سطر السجل. هذا بحث غير تزايدي.

yank-nth-arg (M-C-y)

إدراج المعامل الأول للأمر السابق (عادة الكلمة الثانية في السطر السابق) عند النقطة. باستخدام معامل n، سيُدرج الكلمة رقم n من الأمر السابق (تبدأ الكلمات في الأمر السابق بالكلمة 0). يدرج المعامل السالب الكلمة رقم n من نهاية الأمر السابق. بمجرد حساب المعامل n، يستخدم هذا مرافق توسيع السجل لاستخراج الكلمة رقم n، كما لو أن “!n” توسيع السجل قد حُدد.

yank-last-arg (M-., M-_)

إدراج المعامل الأخير للأمر السابق (آخر كلمة في مدخل السجل السابق). باستخدام معامل عددي، يسلك نفس سلوك yank-nth-arg تمامًا. تتحرك الاستدعاءات المتتالية لـ yank-last-arg للخلف عبر قائمة السجل، وتدرج الكلمة الأخيرة (أو الكلمة المحددة بالمعامل في الاستدعاء الأول) من كل سطر بدوره. يحدد أي معامل عددي يُقدم لهذه الاستدعاءات المتتالية اتجاه التحرك عبر السجل. يغير المعامل السالب الاتجاه عبر السجل (للخلف أو للأمام). يستخدم هذا مرافق توسيع السجل لاستخراج الكلمة الأخيرة، كما لو أن “!$” توسيع السجل قد حُدد.

shell-expand-line (M-C-e)

توسيع السطر بإجراء توسيعات كلمات الصدفة. ينفذ هذا توسيع الأسماء المستعارة والسجل، واقتباس $\*'string\*' و $\*"string\*"، وتوسيع العلامة النونية (tilde)، وتوسيع المعاملات والمتغيرات، والتوسيع الحسابي، وإحلال الأوامر والعمليات، وتقسيم الكلمات، وإزالة علامات الاقتباس. يمنع المعامل الصريح إحلال الأوامر والعمليات. انظر HISTORY EXPANSION أدناه لوصف توسيع السجل.

history-expand-line (M-^)

إجراء توسيع السجل في السطر الحالي. انظر HISTORY EXPANSION أدناه لوصف توسيع السجل.

magic-space

إجراء توسيع السجل في السطر الحالي وإدراج مسافة. انظر HISTORY EXPANSION أدناه لوصف توسيع السجل.

alias-expand-line

إجراء توسيع الأسماء المستعارة في السطر الحالي. انظر ALIASES أعلاه لوصف توسيع الأسماء المستعارة.

history-and-alias-expand-line

إجراء توسيع السجل والأسماء المستعارة في السطر الحالي.

insert-last-argument (M-., M-_)

مرادف لـ yank-last-arg.

edit-and-execute-command (C-x C-e)

استدعاء محرر على سطر الأوامر الحالي، وتنفيذ النتيجة كأوامر صدفة. تحاول Bash استدعاء $VISUAL، ثم $EDITOR، ثم emacs كمحرر، بهذا الترتيب.

أوامر تغيير النص¶

end-of-file (عادة C-d)

المحرف الذي يشير إلى نهاية الملف كما هو محدد، على سبيل المثال، بواسطة stty(1). إذا قُرئ هذا المحرف عندما لا توجد محارف في السطر، وكانت النقطة في بداية السطر، فسوف تفسره readline على أنه نهاية المدخلات وتُعيد EOF.

delete-char (C-d)

حذف المحرف عند النقطة. إذا كانت هذه الوظيفة مرتبطة بنفس المحرف مثل محرف tty EOF، كما هو الحال عادةً مع C-d، فانظر أعلاه لمعرفة التأثيرات. قد يرتبط هذا أيضًا بمفتاح Delete في بعض لوحات المفاتيح.

backward-delete-char (Rubout)

حذف المحرف خلف المؤشر. عند إعطاء معامل عددي، يُحفظ النص المحذوف في حلقة الحذف (kill ring).

forward-backward-delete-char

حذف المحرف الموجود تحت المؤشر، ما لم يكن المؤشر في نهاية السطر، وفي هذه الحالة يُحذف المحرف الموجود خلف المؤشر.

quoted-insert (C-q, C-v)

إضافة المحرف التالي المكتوب إلى السطر حرفيًا. هذه هي طريقة إدراج محارف مثل C-q، على سبيل المثال.

tab-insert (C-v TAB)

إدراج محرف جدولة (tab).

self-insert (a, b, A, 1, !, ...)

إدراج المحرف المكتوب.

bracketed-paste-begin

هذه الوظيفة مخصصة لتكون مرتبطة بـ “bracketed paste” تسلسل الهروب الذي ترسله بعض الطرفيات، ويُعين هذا الارتباط مبدئيًا. يسمح لـ readline بإدراج النص الملصق كوحدة واحدة دون معاملة كل محرف كما لو كان قد قُرئ من لوحة المفاتيح. تُدرج المحارف الملصقة كما لو كان كل واحد منها مرتبطًا بـ self-insert بدلاً من تنفيذ أي أوامر تحرير.

يضبط اللصق المجمع المنطقة على النص المدرج ويفعل المنطقة.

transpose-chars (C-t)

سحب المحرف الموجود قبل النقطة للأمام فوق المحرف الموجود عند النقطة، مع تحريك النقطة للأمام أيضًا. إذا كانت النقطة في نهاية السطر، فإن هذا يبدل موضع المحرفين اللذين يسبقان النقطة. ليس للمعاملات السالبة أي تأثير.

transpose-words (M-t)

سحب الكلمة الموجودة قبل النقطة لتتجاوز الكلمة الموجودة بعد النقطة، مع تحريك النقطة لتتجاوز تلك الكلمة أيضًا. إذا كانت النقطة في نهاية السطر، فإن هذا يبدل موضع آخر كلمتين في السطر.

shell-transpose-words (M-C-t)

سحب الكلمة الموجودة قبل النقطة لتتجاوز الكلمة الموجودة بعد النقطة، مع تحريك النقطة لتتجاوز تلك الكلمة أيضًا. إذا كانت نقطة الإدراج في نهاية السطر، فإن هذا يبدل موضع آخر كلمتين في السطر. حدود الكلمات هي نفسها في shell-forward-word و shell-backward-word.

upcase-word (M-u)

تحويل الكلمة الحالية (أو التالية) إلى أحرف كبيرة. باستخدام معامل سالب، تُحول الكلمة السابقة إلى أحرف كبيرة، ولكن دون تحريك النقطة.

downcase-word (M-l)

حوّل الكلمة الحالية (أو التالية) إلى أحرف صغيرة. عند توفير معطى سالب، تُحوّل الكلمة السابقة إلى أحرف صغيرة، ولكن لا تُنقل النقطة.

capitalize-word (M-c)

اجعل الحرف الأول من الكلمة الحالية (أو التالية) كبيراً. عند توفير معطى سالب، يُحوّل الحرف الأول من الكلمة السابقة إلى حرف كبير، ولكن لا تُنقل النقطة.

overwrite-mode

بدّل وضع الكتابة الفوقية. عند توفير معطى عددي موجب صريح، يُنتقل إلى وضع الكتابة الفوقية. وعند توفير معطى عددي غير موجب، يُنتقل إلى وضع الإدراج. يؤثر هذا الأمر على وضع emacs فقط؛ حيث يتعامل وضع vi مع الكتابة الفوقية بشكل مختلف. تبدأ كل استدعاء لـ readline() بوضع الإدراج.

في وضع الكتابة الفوقية، المحارف المرتبطة بـ self-insert تستبدل النص عند النقطة بدلاً من دفع النص إلى اليمين. المحارف المرتبطة بـ backward-delete-char تستبدل المحرف الذي يسبق النقطة بمسافة. افتراضياً، هذا الأمر غير مرتبط بمفتاح، ولكن قد يُربط بمفتاح Insert في بعض لوحات المفاتيح.

القتل والجذب (Killing and Yanking)¶

kill-line (C-k)

اقضِ على (Kill) النص من النقطة إلى نهاية السطر الحالي. عند توفير معطى عددي سالب، يُقضى على النص رجوعاً من المؤشر إلى بداية السطر.

backward-kill-line (C-x Rubout)

اقضِ على النص رجوعاً إلى بداية السطر الحالي. عند توفير معطى عددي سالب، يُقضى على النص للأمام من المؤشر إلى نهاية السطر.

unix-line-discard (C-u)

اقضِ على النص رجوعاً من النقطة إلى بداية السطر، مع حفظ النص المقتول في حلقة القتل (kill-ring).

kill-whole-line

اقضِ على جميع المحارف في السطر الحالي، بغض النظر عن موقع النقطة.

kill-word (M-d)

اقضِ على النص من النقطة إلى نهاية الكلمة الحالية، أو إلى نهاية الكلمة التالية إذا كنت بين الكلمات. حدود الكلمات هي نفسها المستخدمة في forward-word.

backward-kill-word (M-Rubout)

اقضِ على الكلمة التي خلف النقطة. حدود الكلمات هي نفسها المستخدمة في backward-word.

shell-kill-word (M-C-d)

اقضِ على النص من النقطة إلى نهاية الكلمة الحالية، أو إلى نهاية الكلمة التالية إذا كنت بين الكلمات. حدود الكلمات هي نفسها المستخدمة في shell-forward-word.

shell-backward-kill-word

اقضِ على الكلمة التي خلف النقطة. حدود الكلمات هي نفسها المستخدمة في shell-backward-word.

unix-word-rubout (C-w)

اقضِ على الكلمة التي خلف النقطة، باستخدام المسافة الفارغة كحد للكلمة، مع حفظ النص المقتول في حلقة القتل.

unix-filename-rubout

اقضِ على الكلمة التي خلف النقطة، باستخدام المسافة الفارغة وحرف المائل (slash) كحدود للكلمة، مع حفظ النص المقتول في حلقة القتل.

delete-horizontal-space (M-\)

احذف جميع المسافات وعلامات الجدولة حول النقطة.

kill-region

اقضِ على النص الموجود في المنطقة (region) الحالية.

copy-region-as-kill

انسخ النص الموجود في المنطقة إلى مخزن القتل (kill buffer)، ليتمكن من جذبه (yanked) فوراً.

copy-backward-word

انسخ الكلمة التي تسبق النقطة إلى مخزن القتل. حدود الكلمات هي نفسها المستخدمة في backward-word.

copy-forward-word

انسخ الكلمة التي تلي النقطة إلى مخزن القتل. حدود الكلمات هي نفسها المستخدمة في forward-word.

yank (C-y)

اجذب رأس حلقة القتل إلى المخزن عند النقطة.

yank-pop (M-y)

دوّر حلقة القتل، واجذب الرأس الجديد. لا يعمل إلا بعد yank أو yank-pop.

المعطيات العددية¶

digit-argument (M-0, M-1, ..., M--)

أضف هذا الرقم إلى المعطى المتراكم حالياً، أو ابدأ معطى جديداً. M-- تبدأ معطى سالباً.

universal-argument

هذه طريقة أخرى لتحديد معطى. إذا تلا هذا الأمر رقم أو أكثر، مسبوقاً اختيارياً بعلامة ناقص، فإن تلك الأرقام تُحدد المعطى. إذا تلا الأمر أرقام، فإن تنفيذ universal-argument مرة أخرى ينهي المعطى العددي، ولكنه يُتجاهل فيما عدا ذلك. كحالة خاصة، إذا تلا هذا الأمر مباشرة محرف ليس رقماً ولا علامة ناقص، يُضرب عدد المعطيات للأمر التالي في أربعة. يكون عدد المعطيات واحداً في البداية، لذا فإن تنفيذ هذه الدالة للمرة الأولى يجعل العدد أربعة، وللمرة الثانية يجعله ستة عشر، وهكذا.

الإكمال¶

complete (TAB)

حاول إجراء إكمال للنص الذي يسبق النقطة. تحاول Bash الإكمال بالتحقق أولاً من وجود أي عمليات إكمال قابلة للبرمجة لكلمة الأمر (انظر Programmable Completion أدناه)، وإلا فإنها تعامل النص كمتغير (إذا بدأ بـ $)، أو اسم مستخدم (إذا بدأ بـ ~)، أو اسم مضيف (إذا بدأ بـ @)، أو أمر (بما في ذلك الأسماء المستعارة والدوال والمبنيات الداخلية) على التوالي. إذا لم ينتج عن أي من هذه مطابقة، فإنها تعود إلى إكمال أسماء الملفات.

possible-completions (M-?)

اسرد الإكمالات المحتملة للنص الذي يسبق النقطة. عند عرض الإكمالات، تضبط readline عدد الأعمدة المستخدمة للعرض حسب قيمة completion-display-width، أو قيمة متغير الصدفة COLUMNS، أو عرض الشاشة، بهذا الترتيب.

insert-completions (M-*)

أدرج جميع إكمالات النص الذي يسبق النقطة التي كان من الممكن إنتاجها بواسطة possible-completions، مفصولة بمسافة.

menu-complete

مشابه لـ complete، ولكنه يستبدل الكلمة المراد إكمالها بمطابقة واحدة من قائمة الإكمالات المحتملة. يؤدي التنفيذ المتكرر لـ menu-complete إلى التنقل عبر قائمة الإكمالات المحتملة، وإدراج كل مطابقة بدورها. في نهاية قائمة الإكمالات، يقرع menu-complete الجرس (وفقاً لإعداد bell-style) ويستعيد النص الأصلي. ينتقل المعطى n بمقدار n موضعاً للأمام في قائمة المطابقات؛ وينتقل المعطى السالب للخلف عبر القائمة. هذا الأمر مُعد ليُربط بمفتاح TAB، ولكنه غير مرتبط افتراضياً.

menu-complete-backward

مطابق لـ menu-complete، ولكنه يتحرك للخلف عبر قائمة الإكمالات المحتملة، كما لو كان menu-complete قد أُعطي معطى سالباً. هذا الأمر غير مرتبط افتراضياً.

export-completions

أجرِ إكمالاً للكلمة التي تسبق النقطة كما هو موضح أعلاه واكتب قائمة الإكمالات المحتملة إلى دفق مخرجات readline باستخدام التنسيق التالي، مع كتابة المعلومات في أسطر منفصلة:

إذا لم تكن هناك مطابقات، فسيكون السطر الأول “0”, ولا يطبع هذا الأمر أي مخرجات بعد S:E. إذا كانت هناك مطابقة واحدة فقط، فسيطبع سطراً واحداً يحتوي عليها. إذا كان هناك أكثر من مطابقة، فسيطبع البادئة المشتركة للمطابقات (والتي قد تكون فارغة) في السطر الأول بعد S:E، ثم المطابقات في الأسطر اللاحقة. في هذه الحالة، سيشمل N السطر الأول الذي يحتوي على البادئة المشتركة.

يجب أن يكون المستخدم أو التطبيق قادراً على استيعاب إمكانية وجود سطر فارغ. القصد هو أن يقرأ المستخدم أو التطبيق N سطراً بعد السطر الذي يحتوي على S:E للحصول على قائمة المطابقة. هذا الأمر غير مرتبط افتراضياً.

delete-char-or-list

يحذف المحرف الموجود تحت المؤشر إذا لم يكن في بداية أو نهاية السطر (مثل delete-char). وفي نهاية السطر، يتصرف بشكل مطابق لـ possible-completions. هذا الأمر غير مرتبط افتراضياً.

complete-filename (M-/)

حاول إكمال اسم الملف للنص الذي يسبق النقطة.

possible-filename-completions (C-x /)

اسرد الإكمالات المحتملة للنص الذي يسبق النقطة، مع معاملته كاسم ملف.

complete-username (M-~)

حاول الإكمال للنص الذي يسبق النقطة، مع معاملته كاسم مستخدم.

possible-username-completions (C-x ~)

اسرد الإكمالات المحتملة للنص الذي يسبق النقطة، مع معاملته كاسم مستخدم.

complete-variable (M-$)

حاول الإكمال للنص الذي يسبق النقطة، مع معاملته كمتغير صدفة.

possible-variable-completions (C-x $)

اسرد الإكمالات المحتملة للنص الذي يسبق النقطة، مع معاملته كمتغير صدفة.

complete-hostname (M-@)

حاول الإكمال للنص الذي يسبق النقطة، مع معاملته كاسم مضيف.

possible-hostname-completions (C-x @)

اسرد الإكمالات المحتملة للنص الذي يسبق النقطة، مع معاملته كاسم مضيف.

complete-command (M-!)

حاول الإكمال للنص الذي يسبق النقطة، مع معاملته كاسم أمر. يحاول إكمال الأوامر مطابقة النص مقابل الأسماء المستعارة، والكلمات المحجوزة، ودوال الصدفة، ومبنيات الصدفة الداخلية، وأخيراً أسماء الملفات القابلة للتنفيذ، بهذا الترتيب.

possible-command-completions (C-x !)

اسرد الإكمالات المحتملة للنص الذي يسبق النقطة، مع معاملته كاسم أمر.

dynamic-complete-history (M-TAB)

حاول الإكمال للنص الذي يسبق النقطة، بمقارنة النص مقابل مدخلات قائمة التاريخ بحثاً عن مطابقات إكمال محتملة.

dabbrev-expand

حاول إجراء إكمال قائمة للنص الذي يسبق النقطة، بمقارنة النص مقابل أسطر من قائمة التاريخ بحثاً عن مطابقات إكمال محتملة.

complete-into-braces (M-{)

أجرِ إكمال اسم الملف وأدرج قائمة الإكمالات المحتملة محصورة بين أقواس متعرجة بحيث تكون القائمة متاحة للصدفة (انظر Brace Expansion أعلاه).

ماكروهات لوحة المفاتيح¶

start-kbd-macro (C-x ()

ابدأ حفظ المحارف المكتوبة في ماكرو لوحة المفاتيح الحالي.

end-kbd-macro (C-x ))

أوقف حفظ المحارف المكتوبة في ماكرو لوحة المفاتيح الحالي واحفظ التعريف.

call-last-kbd-macro (C-x e)

أعد تنفيذ آخر ماكرو لوحة مفاتيح عُرِّف، بجعل المحارف في الماكرو تظهر كما لو كانت مكتوبة من لوحة المفاتيح.

print-last-kbd-macro ()

اطبع آخر ماكرو لوحة مفاتيح عُرِّف بتنسيق مناسب لملف inputrc.

متفرقات¶

re-read-init-file (C-x C-r)

اقرأ محتويات ملف inputrc، وادمج أي ارتباطات أو تخصيصات متغيرات موجودة هناك.

abort (C-g)

أجهض أمر التحرير الحالي واقرع جرس المحطة الطرفية (وفقاً لإعداد bell-style).

do-lowercase-version (M-A, M-B, M-x, ...)

إذا كان المحرف x (المقرون بمفتاح Meta) حرفاً كبيراً، فشغل الأمر المرتبط بالمحرف الصغير المقابل له. السلوك غير محدد إذا كان x حرفاً صغيراً بالفعل.

prefix-meta (ESC)

اقرن المحرف التالي المكتوب بمفتاح Meta. يُعد ESC f مكافئاً لـ Meta-f.

undo (C-_, C-x C-u)

تراجع تزايدي، يُتذكر بشكل منفصل لكل سطر.

revert-line (M-r)

تراجع عن جميع التغييرات التي أجريت على هذا السطر. هذا يشبه تنفيذ أمر undo لمرات كافية لإعادة السطر إلى حالته الأولية.

tilde-expand (M-&)

أجرِ توسيع علامة المدة (tilde expansion) على الكلمة الحالية.

set-mark (C-@, M-<space>)

عيّن العلامة (mark) عند النقطة. إذا وُفر معطى عددي، تُعيّن العلامة عند ذلك الموضع.

exchange-point-and-mark (C-x C-x)

بادل النقطة مع العلامة. عيّن موضع المؤشر الحالي إلى الموضع المحفوظ، ثم عيّن العلامة إلى موضع المؤشر القديم.

character-search (C-])

اقرأ محرفاً وانقل النقطة إلى التواجد التالي لذلك المحرف. يبحث المعطى السالب عن التواجدات السابقة.

character-search-backward (M-C-])

اقرأ محرفاً وانقل النقطة إلى التواجد السابق لذلك المحرف. يبحث المعطى السالب عن التواجدات اللاحقة.

skip-csi-sequence

اقرأ ما يكفي من المحارف لاستيعاب تسلسل متعدد المفاتيح مثل تلك المحددة لمفاتيح مثل Home و End. تبدأ تسلسلات CSI بمؤشر تسلسل تحكم (CSI)، وعادة ما يكون ESC [. إذا كان هذا التسلسل مرتبطاً بـ “\e[”, المفاتيح التي تنتج تسلسلات CSI لن يكون لها أي تأثير ما لم تُربط صراحة بأمر readline، بدلاً من إدراج محارف شاردة في مخزن التحرير. هذا غير مرتبط افتراضياً، ولكنه يُربط عادة بـ ESC [.

insert-comment (M-#)

بدون معطى عددي، أدرج قيمة متغير comment-begin الخاص بـ readline في بداية السطر الحالي. إذا وُفر معطى عددي، يعمل هذا الأمر كمبدل: إذا كانت المحارف في بداية السطر لا تطابق قيمة comment-begin، فأدرج القيمة؛ وإلا فاحذف المحارف الموجودة في comment-begin من بداية السطر. في كلتا الحالتين، يُقبل السطر كما لو كُتب سطر جديد. القيمة الافتراضية لـ comment-begin تجعل هذا الأمر يحول السطر الحالي إلى تعليق صدفة. إذا أدى المعطى العددي إلى إزالة محرف التعليق، فستنفذ الصدفة السطر.

spell-correct-word (C-x s)

أجرِ تصحيحاً إملائياً للكلمة الحالية، مع معاملتها كدليل أو اسم ملف، بنفس طريقة خيار الصدفة cdspell. حدود الكلمات هي نفسها المستخدمة في shell-forward-word.

glob-complete-word (M-g)

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

glob-expand-word (C-x *)

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

glob-list-expansions (C-x g)

اعرض قائمة التوسيعات التي كان من الممكن إنتاجها بواسطة glob-expand-word وأعد عرض السطر. إذا وُفر معطى عددي، فألحق * قبل توسيع المسار.

dump-functions

اطبع جميع الدوال وارتباطات مفاتيحها إلى دفق مخرجات readline. إذا وُفر معطى عددي، فسيُنَسَّق المخرج بطريقة تسمح بجعله جزءاً من ملف inputrc.

dump-variables

اطبع جميع متغيرات readline القابلة للضبط وقيمها إلى دفق مخرجات readline. إذا وُفر معطى عددي، فسيُنَسَّق المخرج بطريقة تسمح بجعله جزءاً من ملف inputrc.

dump-macros

اطبع جميع تسلسلات مفاتيح readline المرتبطة بماكروهات والسلاسل النصية التي تنتجها إلى دفق مخرجات readline. إذا وُفر معطى عددي، فسيُنَسَّق المخرج بطريقة تسمح بجعله جزءاً من ملف inputrc.

execute-named-command (M-x)

اقرأ اسم أمر readline قابل للربط من المدخلات ونفذ الدالة المرتبط بها، كما لو ظهر تسلسل المفاتيح المرتبط به في المدخلات. إذا زُوِّدت هذه الدالة بمعطى عددي، فإنها تمرر ذلك المعطى إلى الدالة التي تنفذها.

display-shell-version (C-x C-v)

اعرض معلومات الإصدار عن نسخة bash الحالية.

الإكمال القابل للبرمجة¶

عندما يحاول مستخدم إكمال كلمة لأمر ما أو لمعامل أمر حُدِّدت له مواصفات إكمال (compspec) باستخدام الأمر المدمج complete (انظر أوامر الصدفة المدمجة أدناه)، تستدعي مكتبة readline مرافق الإكمال القابلة للبرمجة.

أولاً، تحدد bash اسم الأمر. إذا كانت مواصفات الإكمال (compspec) قد حُدِّدت لهذا الأمر، تُستخدم هذه المواصفات لإنشاء قائمة من الإكمالات الممكنة للكلمة. إذا كانت كلمة الأمر عبارة عن سلسلة نصية فارغة (محاولة الإكمال في بداية سطر فارغ)، تستخدم bash أي مواصفات إكمال حُدِّدت بالخيار -E للأمر complete. يشير الخيار -I للأمر complete إلى أن كلمة الأمر هي أول كلمة ليست تعييناً على السطر، أو بعد محدد أوامر مثل ; أو |. يشير هذا عادةً إلى إكمال اسم الأمر.

إذا كانت كلمة الأمر مساراً كاملاً، تبحث bash عن مواصفات إكمال للمسار الكامل أولاً. وإذا لم توجد مواصفات للمسار الكامل، تحاول bash العثور على مواصفات للجزء الذي يلي آخر مائلة. وإذا لم تسفر عمليات البحث هذه عن مواصفات إكمال، أو إذا لم تكن هناك مواصفات لكلمة الأمر، تستخدم bash أي مواصفات إكمال حُدِّدت بالخيار -D للأمر complete كإكمال مبدئي. وإذا لم تكن هناك مواصفات مبدئية، تُجري bash توسيع الأسماء المستعارة على كلمة الأمر كملجأ أخير، وتحاول العثور على مواصفات لكلمة الأمر الناتجة عن أي توسيع ناجح.

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

أولاً، تُنفذ bash الـ actions المحددة في مواصفات الإكمال. هذا لا يعيد سوى المطابقات التي تُعد سوابق للكلمة التي يُجرى إكمالها. عند استخدام الخيار -f أو -d لإكمال أسماء الملفات أو الدلائل، تستخدم bash متغير الصدفة FIGNORE لتنقية المطابقات.

بعد ذلك، ينشئ الإكمال القابل للبرمجة مطابقات محددة بنمط توسيع مسار قُدِّم كمعامل للخيار -G. لا يشترط في الكلمات الناتجة عن النمط أن تطابق الكلمة التي يُجرى إكمالها. تستخدم Bash متغير FIGNORE لتنقية المطابقات، لكنها لا تستخدم متغير الصدفة GLOBIGNORE.

بعد ذلك، ينظر الإكمال في السلسلة المحددة كمعامل للخيار -W. تُقسم السلسلة أولاً باستخدام الأحرف الموجودة في متغير IFS الخاص كفواصل. يحترم هذا اقتباسات الصدفة داخل السلسلة، لتوفير آلية للكلمات كي تحتوي على رموز الصدفة الخاصة (metacharacters) أو أحرف من قيمة IFS. ثم تُوسع كل كلمة باستخدام توسيع الأقواس، وتوسيع المدة (~)، وتوسيع المعاملات والمتغيرات، واستبدال الأوامر، والتوسيع الحسابي، كما هو موضح أعلاه تحت توسيع. تُقسم النتائج باستخدام القواعد الموضحة أعلاه تحت Word Splitting. تُطابق نتائج التوسيع كسوابق مع الكلمة التي يُجرى إكمالها، وتصبح الكلمات المطابقة إكمالات ممكنة.

بعد توليد هذه المطابقات، ينفذ bash أي دالة صدفة أو أمر حُدد بالخيارين -F و -C. عند استدعاء الأمر أو الدالة، يعين bash قيمًا لمتغيرات COMP_LINE، و COMP_POINT، و COMP_KEY، و COMP_TYPE كما هو موضح أعلاه تحت متغيرات الصدفة. إذا استُدعيت دالة صدفة، يضبط bash أيضًا متغيرات COMP_WORDS و COMP_CWORD. عند استدعاء الدالة أو الأمر، يكون المعامل الأول ($1) هو اسم الأمر الذي يُجرى إكمال معاملاته، والمعامل الثاني ($2) هو الكلمة التي يُجرى إكمالها، والمعامل الثالث ($3) هو الكلمة التي تسبق الكلمة الجاري إكمالها في سطر الأوامر الحالي. لا يُجرى ترشيح لعمليات الإكمال المولدة مقابل الكلمة الجاري إكمالها؛ فالدالة أو الأمر يتمتعان بحرية كاملة في توليد المطابقات وليس بالضرورة أن تطابق سابقة الكلمة.

تُستدعى أي دالة محددة بـ -F أولاً. يمكن للدالة استخدام أي من مرافق الصدفة، بما في ذلك الأوامر المدمجة compgen و compopt الموضحة أدناه، لتوليد المطابقات. ويجب أن تضع عمليات الإكمال الممكنة في متغير المصفوفة COMPREPLY، عنصرًا واحدًا لكل عنصر مصفوفة.

بعد ذلك، يُستدعى أي أمر محدد بالخيار -C في بيئة مكافئة لاستبدال الأوامر. يجب أن يطبع قائمة بعمليات الإكمال، واحدة في كل سطر، إلى المخرج القياسي. ستقوم الخط المائل العكسي (Backslash) بهروب سطر جديد إذا لزم الأمر. تُضاف هذه إلى مجموعة عمليات الإكمال الممكنة.

بعد توليد جميع عمليات الإكمال الممكنة، يطبق bash أي مرشح (filter) محدد بالخيار -X على عمليات الإكمال في القائمة. المرشح هو نمط يُستخدم كما في توسيع مسار الملف؛ وتُستبدل علامة & في النمط بنص الكلمة التي يُجرى إكمالها. يمكن هروب علامة & حرفية باستخدام الخط المائل العكسي؛ ويُحذف الخط المائل العكسي قبل محاولة المطابقة. يُحذف أي إكمال يطابق النمط من القائمة. علامة ! في البداية تنفي النمط؛ وفي هذه الحالة يحذف bash أي إكمال لا يطابق النمط. إذا فُعّل خيار الصدفة nocasematch، فسيجري bash المطابقة دون مراعاة لحالة الأحرف.

أخيرًا، يضيف الإكمال القابل للبرمجة أي سابقة ولاحقة محددة بالخيارين -P و -S على التوالي إلى كل إكمال، ويعيد النتيجة إلى readline كقائمة بعمليات الإكمال الممكنة.

إذا لم تُنشئ الإجراءات المطبقة سابقاً أي مطابقات، وكان الخيار -o dirnames قد قُدِّم للأمر complete عند تعريف مواصفات الإكمال، تحاول bash إكمال أسماء الدلائل.

إذا قُدِّم الخيار -o plusdirs للأمر complete عند تعريف مواصفات الإكمال، تحاول bash إكمال أسماء الدلائل وتضيف أي مطابقات إلى مجموعة الإكمالات الممكنة.

مبدئياً، إذا عُثر على مواصفات إكمال، فإن كل ما تنتجه يُعاد إلى كود الإكمال كالمجموعة الكاملة للإكمالات الممكنة. وتُعطل إكمالات bash المبدئية وإكمال أسماء الملفات المبدئي في readline. إذا قُدِّم الخيار -o bashdefault للأمر complete عند تعريف مواصفات الإكمال، ولم تنتج المواصفات أي مطابقات، تحاول bash إجراء إكمالاتها المبدئية. وإذا لم تنتج مواصفات الإكمال، وإكمالات bash المبدئية (في حال محاولتها)، أي مطابقات، وكان الخيار -o default قد قُدِّم للأمر complete عند تعريف المواصفات، يُجري الإكمال القابل للبرمجة إكمال readline المبدئي.

يمكن للخيارات المقدمة للأمرين complete و compopt التحكم في كيفية تعامل readline مع الإكمالات. على سبيل المثال، يخبر الخيار -o fullquote مكتبة readline باقتباس المطابقات كما لو كانت أسماء ملفات. انظر وصف complete أدناه للحصول على التفاصيل.

عندما تشير مواصفات الإكمال إلى أنها تريد إكمال أسماء الدلائل، تجبر وظائف الإكمال القابلة للبرمجة مكتبة readline على إلحاق مائلة بالأسماء المكتملة التي هي روابط رمزية لدلائل، وفقاً لقيمة متغير mark-directories في readline، بغض النظر عن إعداد متغير mark-symlinked-directories في readline.

يوجد بعض الدعم لتعديل الإكمالات ديناميكياً. هذا مفيد للغاية عند استخدامه مع إكمال مبدئي محدد باستخدام complete -D. من الممكن لدوال الصدفة التي تُنفذ كدوال إكمال أن تشير إلى وجوب إعادة محاولة الإكمال عن طريق إعادة حالة خروج 124. إذا أعادت دالة صدفة القيمة 124، وغيرت مواصفات الإكمال المرتبطة بالأمر الذي يُجرى محاولة إكماله (المقدم كمعامل أول عند تنفيذ الدالة)، يبدأ الإكمال القابل للبرمجة من جديد، مع محاولة العثور على مواصفات إكمال جديدة لهذا الأمر. يمكن استخدام هذا لبناء مجموعة من الإكمالات ديناميكياً أثناء محاولة الإكمال، بدلاً من تحميلها جميعاً مرة واحدة.

على سبيل المثال، بفرض وجود مكتبة لمواصفات الإكمال، كل منها محفوظ في ملف يقابل اسم الأمر، فإن دالة الإكمال المبدئية التالية ستحمل الإكمالات ديناميكياً:

_completion_loader()
{


  . "/etc/bash_completion.d/$1.sh".if  0<80n \


>/dev/null 2>&1 && return 124
}
complete -D -F _completion_loader.if  0<80n \


-o bashdefault -o default

واسمات الأحداث¶

واسم الحدث هو مرجع لمدخل في قائمة التاريخ. يتكون واسم الحدث من جزء الكلمة الذي يبدأ بحرف توسيع التاريخ وينتهي بواسم الكلمة إذا وُجد، أو بنهاية الكلمة. وما لم يكن المرجع مطلقاً، تكون الأحداث نسبية للموضع الحالي في قائمة التاريخ.

!

بدء استبدال التاريخ، إلا إذا كان متبوعاً بـ فراغ، أو سطر جديد، أو عودة عربة، أو =، أو ( عندما يكون خيار الصدفة extglob مفعلاً باستخدام الأمر المدمج shopt.

!n

الرجوع إلى مدخل قائمة التاريخ رقم n.

!-n

الرجوع إلى المدخل الحالي ناقص n.

!!

الرجوع إلى المدخل السابق. هذا مرادف لـ “!-1”.

!string

الرجوع إلى أحدث أمر يسبق الموضع الحالي في قائمة التاريخ ويبدأ بـ string.

!?string[?]

الرجوع إلى أحدث أمر يسبق الموضع الحالي في قائمة التاريخ ويحتوي على string. يمكن حذف علامة ? الختامية إذا كان string متبوعاً مباشرة بسطر جديد. إذا كان string مفقوداً، فسيستخدم هذا السلسلة من أحدث بحث؛ ويُعد خطأً إذا لم توجد سلسلة بحث سابقة.

^string1^string2^

استبدال سريع. تكرار الأمر السابق، مع استبدال string1 بـ string2. مكافئ لـ “!!:s^string1^string2^” (انظر المغيرات أدناه).

!#

كامل سطر الأوامر المكتوب حتى الآن.

واسمات الكلمات¶

تُستخدم واسمات الكلمات لاختيار كلمات محددة من الحدث. وهي اختيارية؛ إذا لم يُقدم واسم الكلمة، يستخدم توسيع التاريخ الحدث كاملاً. تفصل النقطتان : بين مواصفات الحدث وواسم الكلمة. يمكن حذفها إذا بدأ واسم الكلمة بـ ^، أو $، أو *، أو -، أو %. تُرقم الكلمات من بداية السطر، حيث يرمز للكلمة الأولى بالرقم 0 (صفر). تُدرج الكلمات في السطر الحالي مفصولة بمسافات مفردة.

0 (صفر)

الكلمة رقم صفر. بالنسبة للصدفة، هذه هي كلمة الأمر.

n

الكلمة رقم n.

^

المعامل الأول: الكلمة رقم 1.

$

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

%

الكلمة الأولى المطابقة لأحدث “?string?” بحث، إذا بدأت سلسلة البحث بحرف هو جزء من كلمة. مبدئياً، تبدأ عمليات البحث من نهاية كل سطر وتتجه نحو البداية، لذا فإن أول كلمة مطابقة هي الأقرب لنهاية السطر.

x-y

نطاق من الكلمات؛ “-y” تختصر “0-y”.

*

جميع الكلمات عدا الكلمة رقم صفر. هذا مرادف لـ “1-$”. ليس من الخطأ استخدام * إذا كانت هناك كلمة واحدة فقط في الحدث؛ إذ تتوسع إلى سلسلة نصية فارغة في تلك الحالة.

x*

تختصر x-$.

x-

تختصر x-$ مثل x*، ولكنها تحذف الكلمة الأخيرة. إذا كان x مفقوداً، فإن قيمته المبدئية تكون 0.

إذا قُدم واسم كلمة بدون مواصفات حدث، يُستخدم الأمر السابق كحدث، وهذا يكافئ !!.

المعدلات¶

بعد واسم الكلمة الاختياري، قد يتضمن التوسيع تسلسلاً من مغير واحد أو أكثر من المغيرات التالية، كل منها مسبوق بـ “:”. تقوم هذه بتعديل أو تحرير الكلمة أو الكلمات المختارة من حدث التاريخ.

h

إزالة مكون مسار لاحق، مع ترك الرأس فقط.

t

إزالة جميع مكونات المسار البادئة، مع ترك الذيل.

r

إزالة لاحقة من شكل .xxx، مع ترك الاسم الأساسي.

e

إزالة كل شيء ما عدا اللاحقة الأخيرة.

p

طباعة الأمر الجديد دون تنفيذه.

q

اقتباس الكلمات المستبدلة، مع هرب أي استبدالات أخرى.

x

اقتباس الكلمات المستبدلة كما هو الحال مع q، ولكن مع تقسيمها إلى كلمات عند الـ فراغات والأسطر الجديدة. المغيران q و x متعارضان؛ ويستخدم التوسيع آخر مغير قُدم.

s/old/new/

استبدال new بأول ظهور لـ old في سطر الحدث. يمكن استخدام أي حرف كمحدد بدلاً من /. المحدد النهائي اختياري إذا كان هو الحرف الأخير في سطر الحدث. تقوم المائلة الخلفية الواحدة باقتباس المحدد في old و new. إذا ظهرت علامة & في new، تُستبدل بـ old. وتقوم المائلة الخلفية الواحدة باقتباس &. إذا كان old فارغاً، يُعين على آخر old استُبدل، أو إذا لم تحدث استبدالات تاريخ سابقة، يُعين على آخر string في بحث !?string[?]. إذا كان new فارغاً، يُحذف كل old مطابق.

&

تكرار الاستبدال السابق.

g

جعل التغييرات تُطبق على سطر الحدث بالكامل. يُستخدم هذا بالاقتران مع “:s” (على سبيل المثال، “:gs/old/new/”) أو “:&”. وإذا استُخدم مع “:s”, فيمكن استخدام أي محدد بدلاً من /، ويكون المحدد النهائي اختيارياً إذا كان هو الحرف الأخير في سطر الحدث. ويمكن استخدام a كمرادف لـ g.

G

تطبيق الـ “s” أو “&” مغير التالي مرة واحدة على كل كلمة في سطر الحدث.