الفرق بين المراجعتين ل"Ruby/Dir/glob"

مراجعة 16:37، 23 سبتمبر 2018

يوسّع التابع glob الوسيط الممرّر pattern (انظر فقرة البنية العامة)، والذي هو عبارة عن سلسلة نصية نمطية (pattern string) أو مصفوفة من السلاسل النصية النمطية، ويعيد مصفوفة تحتوي أسماء الملفات المتطابقة لذلك النمط. في حال تم إعطاء كتلة (block)، فسيستدعي التابع glob الكتلة مرة واحدة على كل اسم ملف مطابق، بحيث يمرّر اسم الملف كوسيط إلى الكتلة.

يحدد الوسيط الاختياري base المجلد الأساسي (base directory) لتأويل أسماء المسارات (pathnames) بدلاً من مجلد العمل الحالي. بما أنّ النتائج لا تكون مسبوقة باسم المجلد الأساسي في هذه الحالة، فسيكون عليك إضافة اسم المجلد الأساسي إذا أردت الحصول على مسارات حقيقية.

تجدر الإشارة إلى أنّ هذا النمط (pattern) ليس تعبيرًا نمطيًا (regexp)، ولكنّه أقرب إلى shell glob. راجع صفحة File.fnmatch للتعرف على معنى الوسيط flags.

تعتمد الحساسية لحالة الحروف (Case sensitivity) على النظام الخاص بك (يتم تجاهل الملف File::FNM_CASEFOLD) ، كما هو الحال بخصوص الترتيب الذي تٌعاد به النتائج.

`*`	تطابق كل الملفات. يمكن تقييدها بقيم أخرى في `glob`. مكافئة لـ `‏‎/ .* /x‏` في `regexp`.
	*	يطابق كل الملفات
	c*‎	تتطابق مع جميع الملفات التي تبدأ بـ `c`
	‎*c‎	تتطابق مع جميع الملفات التي تنتهي بـ `c`
	c	تطابق جميع الملفات التي تحتوي c (بما في ذلك في البداية أو النهاية)
	لاحظ أنّ هذا لن يتطابق مع الملفات المخفية المشابهة لنظام Unix‏ (Unix-like) (الملفات النقطية dotfiles). لتضمينها في نتائج المطابقة، يجب استخدام الراية `File::FNM_DOTMATCH` أو شيءًا مثل "`{‎,.‎}`‏".
`**`	تطابق المجلدات تعاوديًا (recursively).
?	تطابق أي محرف مُفرد. إذ تكافئ `/‎.{1}‎/` في regexp.
`[set]`	تتطابق مع أي محرف مُفرد في set. تتصرف بالضبط مثل مجموعات الأحرف في Regexp، بما في المجموعات المنفية (`[^a-z]`).
`{p,q}`	تتطابق حرفيًا إما مع `p` أو مع `q`. وتكافئ النمط التناوبي (pattern alternation) في regexp. المطابقة الحرفية قد تكون أكثر من حرف واحد. قد يتم تحديد أكثر من حرفين.
`\`	يُخلّص (Escapes) الحرف التالي. لاحظ أنّ هذا يعني أنه لا يمكنك استخدام الشرطة المائلة للخلف (`\`) في ويندوز في `glob`، أي أن `Dir ["c: \ foo "]‎` لن تعمل ، استخدم `Dir ["c: / foo "]`‎ بدلاً من ذلك.

البنية العامة

each_child( dirname ) {| filename | block } → nil click to toggle source
each_child( dirname, encoding: enc ) {| filename | block } → nil
each_child( dirname ) → an_enumerator
each_child( dirname, encoding: enc ) → an_enumerator

المعاملات

`dirname`

يحدد اسم المجلد.

`encoding`

يحدد ترميز المجلد.

القيمة المٌعادة

في حال تمرير كتلة فالقيمة المعادة للتابع chdir ستكون nil، وإلا فسيعاد كائن من النوع enumerator.

أمثلة

مثال عن استخدام التابع glob على المجلد testdir الذي يحتوي ملفين عاديين (config.h و main.rb) ، والمجلد الأب (..) ، والمجلد نفسه (.).

Dir.each_child("testdir") {|x| puts "Got #{x}" }

سينتج:

Got config.h
Got main.rb

أنظر أيضًا

صفحة الصنف Dir.
التابع foreach: يستدعي التابع glob الكتلة المعطاة على كل ملف من الملفات المحتواة في المجلد المحدد باستثناء ".." و ".". حيث يمُمرّر أسماء تلك الملفات كوسائط للكتلة.

مصادر

قسم التابع glob في الصنف Dir في توثيق روبي الرسمي.

@@ سطر 12: / سطر 12: @@
   {| class="wikitable"
-| rowspan="6" |
+| rowspan="6" |<code>*</code>
 *
 | colspan="2" |تطابق كل الملفات. يمكن تقييدها بقيم أخرى في <code>glob</code>. مكافئة لـ <code>‏‎/ .* /x‏</code> في <code>regexp</code>.
@@ سطر 30: / سطر 30: @@
 | colspan="2" |لاحظ أنّ هذا لن يتطابق مع الملفات المخفية المشابهة لنظام  Unix‏ (Unix-like) (الملفات النقطية dotfiles). لتضمينها في نتائج المطابقة، يجب استخدام الراية <code>File::FNM_DOTMATCH</code> أو شيءًا مثل "<code>{‎*,.*‎}</code>‏".
 |-
-|**
+|<code>**</code>
 | colspan="2" |تطابق المجلدات تعاوديًا (recursively).
 |-
@@ سطر 36: / سطر 36: @@
 | colspan="2" |تطابق أي محرف مُفرد. إذ تكافئ <code>/‎.{1}‎/</code> في regexp.
 |-
-|[set]
+|<code>[set]</code>
 | colspan="2" |تتطابق مع أي محرف مُفرد في set. تتصرف بالضبط مثل مجموعات الأحرف في Regexp، بما في المجموعات المنفية (<code>[^a-z]</code>).
 |-
-|{p,q}
+|<code>{p,q}</code>
 | colspan="2" |تتطابق حرفيًا إما مع <code>p</code> أو مع <code>q</code>. وتكافئ النمط التناوبي (pattern alternation) في regexp.
 المطابقة الحرفية قد تكون أكثر من حرف واحد. قد يتم تحديد أكثر من حرفين.
 |-
-|
+|<code>\</code>
-|
+| colspan="2" |يُخلّص (Escapes)  الحرف  التالي.
-|
+لاحظ أنّ هذا يعني أنه لا يمكنك استخدام الشرطة المائلة للخلف (<code>\</code>) في ويندوز  في <code>glob</code>، أي أن <code>Dir ["c: \ foo *"]‎</code> لن تعمل ، استخدم <code>Dir ["c: / foo *"]</code>‎ بدلاً من ذلك.
 |}
-\
-يهرب من الحرف الأول التالي.
-لاحظ أن هذا يعني أنه لا يمكنك استخدام الشرطة المائلة للخلف على النوافذ كجزء من الكرة الأرضية ، أي أن Dir ["c: \ foo *"] لن يعمل ، استخدم Dir ["c: / foo *"] بدلاً من ذلك.
 == البنية العامة ==
 <syntaxhighlight lang="ruby">