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

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

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

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

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

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

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

إذا سبقت الكلمة المحجوزة time أنبوبًا برمجيًا، يتم الإبلاغ عن الوقت المنقضي بالإضافة إلى وقت المستخدم والنظام المستهلك في تنفيذه عند انتهاء الأنبوب البرمجي. يغير الخيار -p تنسيق المخرجات إلى التنسيق المحدد بواسطة POSIX. عندما تكون الصدفة في وضع posix mode، فإنها لا تتعرف على time ككلمة محجوزة إذا بدأت الرمز التالي بـ '-'. يمكن ضبط المتغير TIMEFORMAT على سلسلة تنسيق تحدد كيفية عرض معلومات التوقيت؛ انظر وصف TIMEFORMAT تحت Shell Variables أدناه.

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

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

قوائم¶

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

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

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

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

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

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

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

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

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

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

(list)

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

{ list; }

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

((expression))

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

[[ expression ]]

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

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

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

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

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

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

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

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

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

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

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

select name [ in word ] ; do list ; done

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

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

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

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) للصدفة التي أُنشئت لتنفيذ العملية المشتركة متاح كقيمة للمتغير NAME_PID. يمكن استخدام الأمر المدمج wait للانتظار حتى تنتهي العملية المشتركة.

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

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

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

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

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

يعرف هذا دالة باسم fname. الكلمة المحجوزة function اختيارية. إذا تم توفير الكلمة المحجوزة function، تكون الأقواس اختيارية. body الخاص بالدالة هو الأمر المركب compound-command (انظر Compound Commands أعلاه). عادة ما يكون هذا الأمر list من الأوامر بين { و }، ولكن يمكن أن يكون أي أمر مدرج تحت Compound Commands أعلاه. إذا استُخدمت الكلمة المحجوزة function ولم تُوفر الأقواس، يوصى باستخدام الأقواس المتعرجة. يُنفذ compound-command كلما تم تحديد fname كاسم لأمر بسيط. في وضع posix mode، يجب أن يكون fname اسم صدفة صالحًا ولا يجوز أن يكون اسمًا لأحد أوامر POSIX المدمجة الخاصة (special builtins). في الوضع المبدئي، يمكن أن يكون اسم الدالة أي كلمة صدفة غير مقتبسة لا تحتوي على $. يتم تنفيذ أي عمليات إعادة توجيه (انظر REDIRECTION أدناه) محددة عند تعريف الدالة عند تنفيذ الدالة. حالة الخروج لتعريف الدالة هي صفر ما لم يحدث خطأ نحوي أو كانت هناك دالة للقراءة فقط بنفس الاسم موجودة بالفعل. عند التنفيذ، تكون حالة خروج الدالة هي حالة خروج آخر أمر نُفذ في المتن. (انظر FUNCTIONS أدناه).

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

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

عند توسيع معلمة موضعية تتكون من أكثر من رقم واحد، يجب إحاطتها بأقواس متعرجة (انظر EXPANSION أدناه).

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

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

*

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

@

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

#

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

?

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

-

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

$

يتوسع إلى معرف العملية (PID) للصدفة. في الصدفة الفرعية، يتوسع إلى معرف العملية للصدفة الحالية، وليس الصدفة الفرعية.

!

يتوسع إلى معرف العملية (PID) للوظيفة التي وُضعت مؤخرًا في الخلفية، سواء نُفذت كأمر غير متزامن أو باستخدام الأمر المدمج bg (انظر JOB CONTROL أدناه).

0

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

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

تضبط الصدفة المتغيرات التالية:

_

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

BASH

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

BASHOPTS

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

BASHPID

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

BASH_ALIASES

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

BASH_ARGC

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

BASH_ARGV

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

BASH_ARGV0

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

BASH_CMDS

متغير مصفوفة ترابطية تتوافق عناصره مع جدول التجزئة (hash table) الداخلي للأوامر كما يحتفظ به الأمر المدمج 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_LOADABLES_PATH

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

BASH_REMATCH

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

BASH_SOURCE

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

BASH_SUBSHELL

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

BASH_VERSINFO

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

BASH_VERSION

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

COMP_CWORD

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

COMP_KEY

المفتاح (أو المفتاح الأخير في تسلسل مفاتيح) المستخدم لاستدعاء دالة الإكمال الحالية.

COMP_LINE

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

COMP_POINT

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

COMP_TYPE

يُضبط على قيمة عددية مقابلة لنوع محاولة الإكمال التي تسببت في استدعاء دالة الإكمال: TAB للإكمال العادي، ? لعرض عمليات الإكمال بعد ضغطات 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

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

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، لذا فإن كل رقم ناتج ليس له علاقة بالأرقام التي تسبقه. لا يمكن بذر مولد الأرقام العشوائية، لذا فإن عمليات التعيين لهذا المتغير ليس لها أي تأثير. إذا أُلغي تعيين SRANDOM، فإنه يفقد خصائصه الخاصة، حتى لو أُعيد تعيينه لاحقًا.

UID

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

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

BASH_COMPAT

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

BASH_ENV

إذا عُيّنت هذه المعلمة عندما ينفذ bash سكربت صدفة، فستُفسر قيمتها كاسم ملف يحتوي على أوامر لتهيئة الصدفة، كما في ~/.bashrc. تخضع قيمة 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، فسيُحذف من قائمة المطابقات.

HISTCONTROL

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

HISTFILE

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

HISTFILESIZE

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

HISTIGNORE

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

HISTSIZE

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

HISTTIMEFORMAT

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

HOME

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

HOSTFILE

Contains the name of a file in the same format as /etc/hosts that should be read when the shell needs to complete a hostname. The list of possible hostname completions may be changed while the shell is running; the next time hostname completion is attempted after the value is changed, bash adds the contents of the new file to the existing list. If HOSTFILE is set, but has no value, or does not name a readable file, bash attempts to read /etc/hosts to obtain the list of possible hostname completions. When HOSTFILE is unset, the hostname list is cleared.

IFS

فاصل الحقول الداخلي (Internal Field Separator) الذي يُستخدم لتقسيم الكلمات بعد التوسيع ولتقسيم السطور إلى كلمات باستخدام الأمر المدمج read. القيمة المبدئية هي “<مسافة><جدولة><سطر جديد>”.

IGNOREEOF

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

INPUTRC

The filename for the readline startup file, overriding the default of ~/.inputrc (see READLINE below).

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

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

OPTERR

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

PATH

مسار البحث عن الأوامر. وهو قائمة مفصولة بنقطتين للأدلة التي تبحث فيها الـ صدفة عن الأوامر (انظر تنفيذ الأوامر أدناه). اسم الدليل بطول صفر (null) في قيمة PATH يشير إلى الدليل الحالي. قد يظهر اسم دليل فارغ كنقطتين متجاورتين، أو كنقطة في البداية أو النهاية. المسار المبدئي يعتمد على النظام، ويضبطه المسؤول الذي يثبت bash. القيمة الشائعة هي ``/usr/local/bin:/usr/local/sbin:/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

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

PS2

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

PS3

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

PS4

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

SHELL

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

TIMEFORMAT

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

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

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

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

TMOUT

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

TMPDIR

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

auto_resume

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

histchars

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

المصفوفات¶

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

تُنشأ مصفوفة مفهرسة آلياً إذا عُيّن أي متغير باستخدام الصيغة name[subscript]=value. يُعامل subscript كتعبير حسابي يجب أن يؤول إلى رقم. للإعلان صراحة عن مصفوفة مفهرسة، استخدم declare -a name (انظر أوامر الصدفة المدمجة أدناه). يُقبل أيضاً declare -a name[subscript]؛ ويُتجاهل subscript.

تُنشأ المصفوفات الترابطية باستخدام declare -A name.

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

تُعين المصفوفات باستخدام تعيينات مركبة على الشكل name=(value1 ... valuen)، حيث يمكن أن يكون كل value على الشكل [subscript]=string. لا تتطلب تعيينات المصفوفة المفهرسة سوى string. يُوسع كل value في القائمة باستخدام كافة توسيعات الصدفة الموضحة أدناه تحت التوسيع. عند التعيين لمصفوفات مفهرسة، إذا زُوّدت الأقواس والاختزال الاختياري، فيُعين هذا الفهرس؛ وإلا فإن فهرس العنصر المعين هو آخر فهرس عُيّن بواسطة الجملة زائد واحد. يبدأ الفهرسة من الصفر.

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

هذه الصيغة مقبولة أيضاً بواسطة الأمر المدمج declare. يمكن تعيين عناصر المصفوفة الفردية باستخدام صيغة name[subscript]=value المذكورة أعلاه. عند التعيين لمصفوفة مفهرسة، إذا كان name مفهرساً برقم سالب، فإن هذا الرقم يُفسر كنسبة لواحد أكبر من أقصى فهرس لـ name، لذا فإن الفهارس السالبة تُعد من نهاية المصفوفة، ويشير الفهرس -1 إلى العنصر الأخير.

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

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

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

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

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

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

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

تقبل الأوامر المدمجة declare و local و readonly الخيار -a لتحديد مصفوفة مفهرسة والخيار -A لتحديد مصفوفة ترابطية. إذا قُدم كلاهما، فإن الخيار -A له الأسبقية. يقبل الأمر المدمج read الخيار -a لتعيين قائمة من الكلمات المقروءة من المدخل القياسي لمصفوفة. تعرض الأوامر المدمجة set و declare قيم المصفوفة بطريقة تسمح بإعادة استخدامها كتعيينات.

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

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

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

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

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

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

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

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

توسيع المد¶

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

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

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

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

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

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

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

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

${parameter}

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

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

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

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

${parameter:-word}

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

${parameter:=word}

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

${parameter:?word}

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

${parameter:+word}

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

${parameter:offset}

${parameter:offset:length}

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

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

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

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

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

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

${!prefix*}

${!prefix@}

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

${!name[@]}

${!name[*]}

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

${#parameter}

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

${parameter#word}

${parameter##word}

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

${parameter%word}

${parameter%%word}

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

${parameter/pattern/string}

${parameter//pattern/string}

${parameter/#pattern/string}

${parameter/%pattern/string}

استبدال الأنماط. يُوسع النمط لإنتاج نمط تماماً كما في توسيع اسم المسار. يُوسع المعامل ويُستبدل أطول تطابق لـ النمط مع قيمته بـ السلسلة. تخضع السلسلة لتوسيع التلدة، وتوسيع المعاملات والمتغيرات، والتوسيع الحسابي، واستبدال الأوامر والعمليات، وإزالة الاقتباس. يُنفذ التطابق باستخدام القواعد الموضوفة تحت مطابقة الأنماط أدناه. في النموذج الأول أعلاه، يُستبدل التطابق الأول فقط. وإذا وُجدت مائلتان (slashes) تفصلان بين المعامل و النمط (النموذج الثاني أعلاه)، تُستبدل جميع تطابقات النمط بـ السلسلة. وإذا كان النمط مسبوقاً بـ # (النموذج الثالث أعلاه)، فيجب أن يطابق بداية القيمة الموسعة لـ المعامل. وإذا كان النمط مسبوقاً بـ % (النموذج الرابع أعلاه)، فيجب أن يطابق نهاية القيمة الموسعة لـ المعامل. إذا كان توسيع السلسلة فارغاً، تُحذف تطابقات النمط. وإذا كانت السلسلة فارغة، تُحذف تطابقات النمط ويمكن حذف / التي تلي النمط.

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

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

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

${المعامل^النمط}

${المعامل^^النمط}

${parameter,pattern}

${parameter,,pattern}

تعديل الحالة. يقوم هذا التوسيع بتعديل حالة المحارف الأبجدية في المعامل. يُوسع النمط لإنتاج نمط تماماً كما في توسيع اسم المسار. يُختبر كل محرف في القيمة الموسعة لـ المعامل مقابل النمط، وإذا طابق النمط، تُحول حالته. يجب ألا يحاول النمط مطابقة أكثر من محرف واحد. يقوم العامل ^ بتحويل الحروف الصغيرة التي تطابق النمط إلى حروف كبيرة؛ ويقوم العامل , بتحويل الحروف الكبيرة المطابقة إلى حروف صغيرة. تقوم توسعات ^^ و ,, بتحويل كل محرف مطابق في القيمة الموسعة؛ أما توسعات ^ و , فتطابق وتُحول فقط المحرف الأول في القيمة الموسعة. إذا حُذف النمط، يُعامل مثل ?، الذي يطابق كل محرف. إذا كان المعامل هو @ أو *، تُطبق عملية تعديل الحالة على كل معامل موضعي بالدور، ويكون التوسيع هو القائمة الناتجة. وإذا كان المعامل متغير مصفوفة متبوعاً بـ @ أو *، تُطبق عملية تعديل الحالة على كل عضو في المصفوفة بالدور، ويكون التوسيع هو القائمة الناتجة.

${parameter@operator}

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

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

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

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

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

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

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

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

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

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

يخضع التعبير لنفس التوسعات كما لو كان داخل علامات اقتباس مزدوجة، ولكن لا تُعامل محارف الاقتباس المزدوج في التعبير معاملة خاصة وتُزال. تخضع جميع الرموز (tokens) في التعبير لتوسيع المعاملات والمتغيرات، واستبدال الأوامر، وإزالة الاقتباس. تُعامل النتيجة كالتعبير الحسابي المراد تقويمه. يمكن أن تكون التوسعات الحسابية متداخلة.

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

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

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

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

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

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

تعامل الصدفة كل محرف من IFS كمحدد، وتقسم نتائج التوسعات الأخرى إلى كلمات باستخدام هذه المحارف كمنهيات للحقول. إذا كان IFS غير معين، أو كانت قيمته هي <space><tab><newline> بالضبط، وهي القيمة المبدئية، فتُتجاهل تتابعات المسافة و الجدولة و السطر الجديد في بداية ونهاية نتائج التوسعات السابقة، وأي تتابع لمحارف IFS ليس في البداية أو النهاية يعمل على تحديد الكلمات. وإذا كانت لـ IFS قيمة غير المبدئية، فتُتجاهل تتابعات محارف المساحة البيضاء المسافة و الجدولة و السطر الجديد في بداية ونهاية الكلمة، طالما كان محرف المساحة البيضاء في قيمة IFS (محرف مساحة بيضاء في IFS). أي محرف في IFS ليس محرف مساحة بيضاء في IFS، مع أي محارف مساحة بيضاء مجاور له في IFS، يحدد حقلاً. ويُعامل تتابع محارف المساحة البيضاء في IFS أيضاً كمحدد. وإذا كانت قيمة IFS فارغة، فلا يحدث تقسيم للكلمات.

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

لاحظ أنه إذا لم يحدث توسيع، فلن يُنفذ أي تقسيم.

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

بعد تقسيم الكلمات، وما لم يُضبط الخيار -f، تمسح bash كل كلمة بحثاً عن المحارف *، و ?، و [. إذا ظهر أحد هذه المحارف، ولم يكن مقتبساً، تُعتبر الكلمة نمطاً، وتُستبدل بقائمة مرتبة أبجدياً من أسماء الملفات المطابقة للنمط (انظر Pattern Matching أدناه). وإذا لم يُعثر على أسماء ملفات مطابقة، ولم يُفعل خيار الصدفة nullglob، تُترك الكلمة دون تغيير. وإذا ضُبط الخيار nullglob، ولم يُعثر على تطابقات، تُزال الكلمة. وإذا ضُبط خيار الصدفة failglob، ولم يُعثر على تطابقات، تُطبع رسالة خطأ ولا يُنفذ الأمر. وإذا فُعل خيار الصدفة nocaseglob، يُنفذ التطابق دون اعتبار لحالة المحارف الأبجدية. لاحظ أنه عند استخدام تعبيرات المدى مثل [a-z] (انظر أدناه)، قد تُضمن أحرف من الحالة الأخرى، اعتماداً على ضبط LC_COLLATE. عندما يُستخدم نمط لتوسيع اسم المسار، يجب مطابقة المحرف “.” في بداية الاسم أو بعد مائلة (slash) مباشرة بشكل صريح، ما لم يُضبط خيار الصدفة dotglob. ومن أجل مطابقة أسماء الملفات “.” و “..”، يجب أن يبدأ النمط بـ “.” (على سبيل المثال، “.?”)، حتى لو ضُبط dotglob. وإذا فُعل خيار الصدفة globskipdots، فلن تُطابق أسماء الملفات “.” و “..” أبداً، حتى لو بدأ النمط بـ “.”. وعند عدم مطابقة أسماء المسارات، لا يُعامل المحرف “.” معاملة خاصة. وعند مطابقة اسم مسار، يجب دائماً مطابقة محرف المائلة بمائلة صريحة في النمط، ولكن في سياقات المطابقة الأخرى يمكن مطابقتها بمحرف نمط خاص كما وُصف أدناه تحت Pattern Matching. انظر وصف shopt أدناه تحت SHELL BUILTIN COMMANDS للحصول على وصف لخيارات الصدفة nocaseglob، و nullglob، و globskipdots، و failglob، و dotglob.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

[n]<<[-]word


        here-document
delimiter

لا يُنفذ توسيع المعاملات والمتغيرات، ولا استبدال الأوامر، ولا التوسيع الحسابي، ولا توسيع اسم المسار على الكلمة. إذا كان أي جزء من الكلمة مقتبساً، يكون المحدد هو نتيجة إزالة الاقتباس عن الكلمة، ولا تُوسع الأسطر في "المستند المضمن" (here-document). أما إذا كانت الكلمة غير مقتبسة، فتخضع جميع أسطر المستند المضمن لتوسيع المعاملات، واستبدال الأوامر، والتوسيع الحسابي، ويُتجاهل تتابع المحارف \<newline>، ويجب استخدام \ لاقتباس المحارف \، و $، و `.

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

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

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

[n]<<<word

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

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

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

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

المعامل

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

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

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

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

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

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

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

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

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

تمثيل Readline¶

في هذا القسم، يُستخدم تدوين أسلوب Emacs للإشارة إلى ضغطات المفاتيح. يُشار إلى مفاتيح التحكم بواسطة C-key، فمثلاً C-n تعني Control-N. وبالمثل، يُشار إلى مفاتيح meta بواسطة M-key، لذا M-x تعني Meta-X. (على لوحات المفاتيح التي لا تحتوي على مفتاح meta، تعني M-x الضغط على ESC x، أي اضغط على مفتاح Escape ثم مفتاح x. وهذا يجعل ESC هي بادئة meta. والتركيبة M-C-x تعني ESC-Control-x، أو الضغط على مفتاح Escape ثم الاستمرار في الضغط على مفتاح Control أثناء الضغط على مفتاح x.)

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

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

تهيِئة Readline¶

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

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

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

أسماء المحارف الرمزية التالية معروفة: RUBOUT، و DEL، و ESC، و LFD، و NEWLINE، و RET، و RETURN، و SPC، و SPACE، و TAB.

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

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

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

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

في المثال أعلاه، رُبط 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، ورُبط ESC [ 1 1 ~ لإدراج النص ``Function Key 1''.

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

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

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

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

متغيرات Readline¶

يحتوي Readline على متغيرات يمكن استخدامها لتخصيص سلوكه بشكل أكبر. يمكن تعيين متغير في ملف inputrc ببيان على الشكل

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

active-region-start-color

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

active-region-end-color

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

bell-style (audible)

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

bind-tty-special-chars (On)

إذا ضُبط على On، يحاول readline ربط محارف التحكم التي يعاملها تعريف طرفية النواة معاملة خاصة بمكافئاتها في readline.

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 (“#”)

السلسلة التي تُدرج عند تنفيذ أمر readline المسمى insert-comment. هذا الأمر مربوط بـ 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)

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

completion-query-items (100)

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

convert-meta (On)

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

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 والتحكم وتسلسلات هروب المائلة العكسية. استخدم مهربات \1 و \2 لبدء وإنهاء تسلسلات المحارف غير المطبوعة، والتي يمكن استخدامها لتضمين تسلسل تحكم طرفي في سلسلة الوضع.

enable-active-region (On)

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

enable-bracketed-paste (On)

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

enable-keypad (Off)

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

enable-meta-key (On)

عند ضبطه على On، سيحاول readline تمكين أي مفتاح مغير meta تدعي الطرفية دعمه عند استدعائه. في العديد من الطرفيات، يُستخدم مفتاح meta لإرسال محارف ذات ثمانية بتات.

expand-tilde (Off)

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

history-preserve-point (Off)

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

history-size (unset)

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

horizontal-scroll-mode (Off)

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

input-meta (Off)

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

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، تُعرض سطور السجل التي عُدلت مسبوقة بعلامة نجمة (*).

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 عارضًا (pager) داخليًا يشبه more لعرض ملء الشاشة من التكملات الممكنة في كل مرة.

print-completions-horizontally (Off)

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

revert-all-at-newline (Off)

إذا ضُبط على On، سيتراجع readline عن جميع التغييرات في سطور السجل قبل العودة عند تنفيذ accept-line. مبدئيًا، يمكن تعديل سطور السجل والاحتفاظ بقوائم تراجع فردية عبر استدعاءات 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 والتحكم وتسلسلات هروب المائلة العكسية. استخدم مهربات \1 و \2 لبدء وإنهاء تسلسلات المحارف غير المطبوعة، والتي يمكن استخدامها لتضمين تسلسل تحكم طرفي في سلسلة الوضع.

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

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

visible-stats (Off)

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

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

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

$if

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

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

$endif

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

$else

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

$include

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

$include  /etc/inputrc

البحث¶

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

تبدأ عمليات البحث التزايدي قبل أن ينتهي المستخدم من كتابة سلسلة البحث. مع كتابة كل محرف من سلسلة البحث، يعرض readline المدخل التالي من السجل الذي يطابق السلسلة المكتوبة حتى الآن. يتطلب البحث التزايدي فقط عددًا من المحارف يكفي للعثور على مدخل السجل المطلوب. تُستخدم المحارف الموجودة في قيمة متغير isearch-terminators لإنهاء البحث التزايدي. إذا لم يُعين لهذا المتغير قيمة، فإن المحرفين Escape و Control-J سيهيان البحث التزايدي. سيؤدي Control-G إلى إجهاض البحث التزايدي واستعادة السطر الأصلي. عند إنهاء البحث، يصبح مدخل السجل الذي يحتوي على سلسلة البحث هو السطر الحالي.

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

يتذكر Readline آخر سلسلة بحث تزايدي. إذا كُتب اثنان من Control-R بدون أي محارف فاصلة تحدد سلسلة بحث جديدة، تُستخدم أي سلسلة بحث محفوظة.

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

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

فيما يلي قائمة بأسماء الأوامر وتسلسلات المفاتيح المبدئية التي رُبطت بها. تكون أسماء الأوامر التي لا يصاحبها تسلسل مفاتيح غير مربوطة مبدئيًا. في الأوصاف التالية، تشير الـ نقطة (point) إلى موضع المؤشر الحالي، وتشير الـ علامة (mark) إلى موضع مؤشر حُفظ بواسطة أمر set-mark. يُشار إلى النص الموجود بين النقطة والعلامة باسم المنطقة (region).

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

beginning-of-line (C-a)

الانتقال إلى بداية السطر الحالي.

end-of-line (C-e)

الانتقال إلى نهاية السطر.

forward-char (C-f)

الانتقال للأمام بمقدار محرف واحد.

backward-char (C-b)

الانتقال للخلف بمقدار محرف واحد.

forward-word (M-f)

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

backward-word (M-b)

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

shell-forward-word

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

shell-backward-word

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

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. إذا كان السطر سطر سجل معدلاً، فسيُستعاد سطر السجل إلى حالته الأصلية.

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)

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

forward-search-history (C-s)

البحث للأمام بدءًا من السطر الحالي والانتقال `للأسفل' عبر السجل حسب الضرورة. هذا بحث تزايدي.

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

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

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

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

history-search-forward

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

history-search-backward

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

history-substring-search-backward

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

history-substring-search-forward

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

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

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

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

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

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

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

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''. إذا قُرئ هذا المحرف في حين لا توجد محارف في السطر، وكانت النقطة في بداية السطر، يفسره readline على أنه نهاية المدخلات ويعيد EOF.

delete-char (C-d)

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

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, !, ...)

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

transpose-chars (C-t)

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

transpose-words (M-t)

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

upcase-word (M-u)

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

downcase-word (M-l)

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

capitalize-word (M-c)

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

overwrite-mode

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

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

kill-line (C-k)

قتل النص من النقطة حتى نهاية السطر.

backward-kill-line (C-x Rubout)

قتل النص للخلف حتى بداية السطر.

unix-line-discard (C-u)

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

kill-whole-line

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

kill-word (M-d)

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

backward-kill-word (M-Rubout)

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

shell-kill-word

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

shell-backward-kill-word

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

unix-word-rubout (C-w)

قتل الكلمة التي خلف النقطة، باستخدام المسافة البيضاء كحد للكلمة. يُحفظ النص المقتول في حلقة القتل.

unix-filename-rubout

قتل الكلمة التي خلف النقطة، باستخدام المسافة البيضاء ومحرف المائلة كحدود للكلمة. يُحفظ النص المقتول في حلقة القتل.

delete-horizontal-space (M-\)

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

kill-region

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

copy-region-as-kill

نسخ النص في المنطقة إلى مخزن القتل.

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 التكملة بمعاملة النص كمتغير (إذا بدأ النص بـ $)، أو اسم مستخدم (إذا بدأ النص بـ ~)، أو اسم مضيف (إذا بدأ النص بـ @)، أو أمر (بما في ذلك الأسماء المستعارة والدوال) بالترتيب. إذا لم ينتج عن أي منها تطابق، تُحاول تكملة اسم الملف.

possible-completions (M-?)

سرد التكملات الممكنة للنص الذي قبل النقطة.

insert-completions (M-*)

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

menu-complete

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

menu-complete-backward

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

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>)

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

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

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

character-search (C-])

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

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

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

skip-csi-sequence

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

insert-comment (M-#)

بدون معطى عددي، تُدرج قيمة متغير readline المسمى comment-begin في بداية السطر الحالي. إذا وُفر معطى عددي، يعمل هذا الأمر كمبدل: إذا كانت المحارف في بداية السطر لا تطابق قيمة 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 المربوطة بماكرو والسلاسل التي تخرجها. إذا وُفر معطى عددي، يُنسق الإخراج بطريقة تسمح بجعله جزءًا من ملف inputrc.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

_completion_loader()
{
. "/etc/bash_completion.d/$1.sh" >/dev/null 2>&1 && return 124
}
complete -D -F _completion_loader -o bashdefault -o default

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

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

!

بدء استبدال التأريخ، إلا إذا كان متبوعًا بـ فراغ، أو سطر جديد، أو رجوع عربة، أو = أو ( (عند تفعيل خيار الصدفة 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' أو `&' التالي مرة واحدة لكل كلمة في سطر الحدث.