Ruby/Dir/glob

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

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

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

تعتمد الحساسية لحالة الحروف (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 *"]‎ بدلاً من ذلك.

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

glob( pattern, [flags], [base: path] ) → array 
glob( pattern, [flags], [base: path] ) { |filename| block } → nil

المعاملات

pattern

سلسلة نصية نمطية (pattern string) أو مصفوفة من السلاسل النصية النمطية،

flags

ارجع إلى صفحة التابع File.fnmatch للتعرف على الوسيط flags.

base

المجلد الأساسي (base directory) لتأويل أسماء المسارات (pathnames)

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

يعيد مصفوفة تحوي أسماء الملفات المطابقة للنمط pattern.

أمثلة

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

Dir["config.?"]                     #=> ["config.h"]
Dir.glob("config.?")                #=> ["config.h"]
Dir.glob("*.[a-z][a-z]")            #=> ["main.rb"]
Dir.glob("*.[^r]*")                 #=> ["config.h"]
Dir.glob("*.{rb,h}")                #=> ["main.rb", "config.h"]
Dir.glob("*")                       #=> ["config.h", "main.rb"]
Dir.glob("*", File::FNM_DOTMATCH)   #=> [".", "..", "config.h", "main.rb"]

rbfiles = File.join("**", "*.rb")
Dir.glob(rbfiles)                   #=> ["main.rb",
                                    #    "lib/song.rb",
                                    #    "lib/song/karaoke.rb"]

Dir.glob(rbfiles, base: "lib")      #=> ["song.rb",
                                    #    "song/karaoke.rb"]

libdirs = File.join("**", "lib")
Dir.glob(libdirs)                   #=> ["lib"]

librbfiles = File.join("**", "lib", "**", "*.rb")
Dir.glob(librbfiles)                #=> ["lib/song.rb",
                                    #    "lib/song/karaoke.rb"]

librbfiles = File.join("**", "lib", "*.rb")
Dir.glob(librbfiles)                #=> ["lib/song.rb"]

انظر أيضًا

• صفحة الصنف Dir.

مصادر

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