الفرق بين المراجعتين لصفحة: «Ruby/Dir»
لا ملخص تعديل |
جميل-بيلوني (نقاش | مساهمات) طلا ملخص تعديل |
||
| (23 مراجعة متوسطة بواسطة مستخدمين اثنين آخرين غير معروضة) | |||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE: | <noinclude>{{DISPLAYTITLE: الصنف <code>Dir</code> في روبي}}</noinclude> | ||
[[تصنيف: Ruby]] | [[تصنيف: Ruby]] | ||
[[تصنيف: Ruby Class]] | |||
[[تصنيف: Ruby Dir]] | [[تصنيف: Ruby Dir]] | ||
كائنات الصنف<code>Dir</code> هي | كائنات الصنف <code>Dir</code> هي مجاري مجلدات (directory streams) تمثِّل الجلدات في نظام الملفات الأساسي لنظام التشغيل. فهي توفر طرائق متعددة لعرض المجلدات ومحتوياتها. انظر أيضًا صفحة الصنف [[Ruby/File|<code>File</code>]] لمزيد من المعلومات. | ||
يحوي المجلد المستخدم في الأمثلة الموجودة في صفحات التوابع ملفين عاديين هما: <code>config.h</code> و <code>main.rb</code>، بالإضافة إلى المجلد الأب (<code>..</code>) ، والمجلد نفسه (<code>.</code>). | |||
==توابع الصنف العامة (Public Class Methods)== | ==توابع الصنف العامة (Public Class Methods)== | ||
=== | ===المعامل <code rel="mw:WikiLink" title="Ruby/Dir/5B-5D" href="Ruby/Dir/5B-5D">[[Ruby/Dir/5B-5D|[]]]</code>=== | ||
يكافئ استدعاء <code>Dir.glob([string,...], 0)</code>. | |||
=== | ===[[Ruby/Dir/chdir|<code>chdir</code>]]=== | ||
يغيِّر مجلد العمل (working directory) الحالي للعملية الحالية إلى مجلَّدٍ محدَّدٍ. | |||
===[[Ruby/Dir/children|<code>children</code>]]=== | |||
يعيد مصفوفة تحوي جميع أسماء الملفات في المجلد المحدد باستثناء "<code>.</code>" و "<code>..</code>". | |||
===[[Ruby/Dir/chroot|<code>chroot</code>]]=== | |||
يغير المجلد الجذر (root) لنظام الملفات الخاص بالعملية الحالية. | |||
===[[Ruby/Dir/each child|<code>each_child</code>]]=== | |||
يستدعي الكتلة المعطاة على كل ملف أو مجلد موجود في المجلد المحدد باستثناء "<code>..</code>" و "<code>.</code>" إذ يمُمرّر أسماء تلك الملفات كوسائط إلى الكتلة. | |||
===[[Ruby/Dir/delete|<code>delete</code>]]=== | |||
يحذف مجلدًا محدَّدًا. | |||
===[[Ruby/Dir/empty|<code>?empty</code>]]=== | |||
يتحقق فيما إذا كان المجلد المعطى فارغًا. | |||
===[[Ruby/Dir/entries|<code>entries</code>]]=== | |||
يتحقق فيما إذا كان الملف المعطى مجلدًا. | |||
===[[Ruby/Dir/exist|<code>?exist</code>]]=== | |||
يتحقق مما إذا كان الملف المعطى مجلدًا. | |||
===[[Ruby/Dir/exists|<code>exists</code>]]=== | |||
أصبح مهملًا، لذا لا تستخدمه بعد الآن. استعمل التابع <code>[[Ruby/Dir/exist|?exist]]</code> عوضًا عنه. | |||
===[[Ruby/Dir/foreach|<code>foreach</code>]]=== | |||
يستدعي الكتلة المعطاة على كل ملف من الملفات الموجودة في المجلد المحدد، إذ يمُمرّر أسماء تلك الملفات كوسائط للكتلة. | |||
===[[Ruby/Dir/getwd|<code>getwd</code>]]=== | |||
يعيد مسار مجلد العمل (working directory) الحالي للعملية الحالية. | |||
===[[Ruby/Dir/glob|<code>glob</code>]]=== | |||
يوسّع الوسيطَ <code>pattern</code> الممرّر (انظر فقرة البنية العامة)، الذي هو سلسلة نصية نمطية (pattern string) أو مصفوفة من السلاسل النصية النمطية، ويعيد مصفوفة تحتوي أسماء الملفات المُطابقة لذلك النمط. | |||
===[[Ruby/Dir/home|<code>home</code>]]=== | |||
يعيد المجلد الرئيسي (home directory) للمستخدم الحالي أو للمستخدم المعطى في حال إعطائه. | |||
===[[Ruby/Dir/mkdir|<code>mkdir</code>]]=== | |||
ينشئ مجلدًا جديدًا باسم محدَّد، مع تحديد أذوناته أيضًا. | |||
===[[Ruby/Dir/new|<code>new</code>]]=== | |||
يعيد كائنًا مجلديًا (directory object) جديدًا خاصًا بالمجلد المعطى. | |||
===[[Ruby/Dir/open|<code>open</code>]]=== | |||
يفتح مجلدًا محدَّدًا ثمَّ يعيد كائنًا يشير إليه. | |||
===[[Ruby/Dir/pwd|<code>pwd</code>]]=== | |||
يعيد مسار مجلد العمل (working directory) الحالي للعملية. | |||
===[[Ruby/Dir/rmdir|<code>rmdir</code>]]=== | |||
يحذف مجلدًا محدَّدًا. | |||
===[[Ruby/Dir/unlink|<code>unlink</code>]]=== | |||
يحذف مجلدًا محدَّدًا. | |||
==توابع الكائن العامة (Public Instance Methods)== | |||
===[[Ruby/Dir/close|<code>close</code>]]=== | |||
يغلق التابع <code>close</code> مجرى مجلد محدَّدٍ. | |||
===[[Ruby/Dir/each|<code>each</code>]]=== | |||
يستدعي الكتلة المعطاة على كل ملف من الملفات الموجودة في مجلد محدَّد، إذ تمُمرّر أسماء تلك الملفات كوسائط للكتلة. | |||
===[[Ruby/Dir/fileno|<code>fileno</code>]]=== | |||
يعيد عددًا صحيحًا يمثل واصف الملف العددي (numeric file descriptor) المُستخدم في الكائن <code>Dir</code> الذي استُدعي معه. | |||
===[[Ruby/Dir/inspect|<code>inspect</code>]]=== | |||
يعيد سلسلة نصية تصف الكائن <code>Dir</code> الذي استُدعي معه. | |||
===[[Ruby/Dir/path|<code>path</code>]]=== | |||
يعيد المسار المُمرّر إلى الباني <code>[[Ruby/Dir/new|new]]</code> عند إنشائه للكائن <code>Dir</code> المعطى. | |||
===[[Ruby/Dir/pos|<code>pos</code>]]=== | |||
يعيد موضع المؤشر الحالي في المجلد الذي استٌدعي معه. | |||
===[[Ruby/Dir/seek|<code>seek</code>]]=== | |||
يذهب التابع <code>seek</code> إلى موضع محدد في المجلد الذي استٌدعي معه. | |||
===[[Ruby/Dir/pos-3D|<code>pos = integer</code>]]=== | |||
يحدِّد التابع <code>pos</code> عند استدعائه بالشكل <code>pos = integer</code> موضع المؤشر الحالي في المجلد. | |||
===[[Ruby/Dir/read|<code>read</code>]]=== | |||
يقرأ التابع <code>read</code> المدخلة التالية في المجلد الذي استُدعي معه ثم يعيده في سلسلة نصية. | |||
===[[Ruby/Dir/rewind|<code>rewind</code>]]=== | |||
يعيد التابع <code>rewind</code> ضبط موضع المؤشر الحالي في المجلد إلى بدايته. | |||
===[[Ruby/Dir/tell|<code>tell</code>]]=== | |||
يعيد التابع <code>tell</code> الموضع الحالي في المجلد الذي استٌدعي معه. انظر أيضًا التابع <code>[[uby/Dir/seek|seek]]</code>. | |||
===[[Ruby/Dir/to path|<code>to_path</code>]]=== | |||
يعيد المسار المُمرّر إلى الباني <code>[[Ruby/Dir/new|new]]</code> عند إنشائه للكائن <code>Dir</code> المعطى. | |||
==مصادر<span> </span>== | ==مصادر<span> </span>== | ||
*[http://ruby-doc.org/core-2.5.1/Dir.html قسم | *[http://ruby-doc.org/core-2.5.1/Dir.html قسم الصنف Dir في توثيق روبي الرسمي.] | ||
المراجعة الحالية بتاريخ 10:59، 4 ديسمبر 2018
كائنات الصنف Dir هي مجاري مجلدات (directory streams) تمثِّل الجلدات في نظام الملفات الأساسي لنظام التشغيل. فهي توفر طرائق متعددة لعرض المجلدات ومحتوياتها. انظر أيضًا صفحة الصنف File لمزيد من المعلومات.
يحوي المجلد المستخدم في الأمثلة الموجودة في صفحات التوابع ملفين عاديين هما: config.h و main.rb، بالإضافة إلى المجلد الأب (..) ، والمجلد نفسه (.).
توابع الصنف العامة (Public Class Methods)
المعامل []
يكافئ استدعاء Dir.glob([string,...], 0).
chdir
يغيِّر مجلد العمل (working directory) الحالي للعملية الحالية إلى مجلَّدٍ محدَّدٍ.
children
يعيد مصفوفة تحوي جميع أسماء الملفات في المجلد المحدد باستثناء "." و "..".
chroot
يغير المجلد الجذر (root) لنظام الملفات الخاص بالعملية الحالية.
each_child
يستدعي الكتلة المعطاة على كل ملف أو مجلد موجود في المجلد المحدد باستثناء ".." و "." إذ يمُمرّر أسماء تلك الملفات كوسائط إلى الكتلة.
delete
يحذف مجلدًا محدَّدًا.
?empty
يتحقق فيما إذا كان المجلد المعطى فارغًا.
entries
يتحقق فيما إذا كان الملف المعطى مجلدًا.
?exist
يتحقق مما إذا كان الملف المعطى مجلدًا.
exists
أصبح مهملًا، لذا لا تستخدمه بعد الآن. استعمل التابع ?exist عوضًا عنه.
foreach
يستدعي الكتلة المعطاة على كل ملف من الملفات الموجودة في المجلد المحدد، إذ يمُمرّر أسماء تلك الملفات كوسائط للكتلة.
getwd
يعيد مسار مجلد العمل (working directory) الحالي للعملية الحالية.
glob
يوسّع الوسيطَ pattern الممرّر (انظر فقرة البنية العامة)، الذي هو سلسلة نصية نمطية (pattern string) أو مصفوفة من السلاسل النصية النمطية، ويعيد مصفوفة تحتوي أسماء الملفات المُطابقة لذلك النمط.
home
يعيد المجلد الرئيسي (home directory) للمستخدم الحالي أو للمستخدم المعطى في حال إعطائه.
mkdir
ينشئ مجلدًا جديدًا باسم محدَّد، مع تحديد أذوناته أيضًا.
new
يعيد كائنًا مجلديًا (directory object) جديدًا خاصًا بالمجلد المعطى.
open
يفتح مجلدًا محدَّدًا ثمَّ يعيد كائنًا يشير إليه.
pwd
يعيد مسار مجلد العمل (working directory) الحالي للعملية.
rmdir
يحذف مجلدًا محدَّدًا.
unlink
يحذف مجلدًا محدَّدًا.
توابع الكائن العامة (Public Instance Methods)
close
يغلق التابع close مجرى مجلد محدَّدٍ.
each
يستدعي الكتلة المعطاة على كل ملف من الملفات الموجودة في مجلد محدَّد، إذ تمُمرّر أسماء تلك الملفات كوسائط للكتلة.
fileno
يعيد عددًا صحيحًا يمثل واصف الملف العددي (numeric file descriptor) المُستخدم في الكائن Dir الذي استُدعي معه.
inspect
يعيد سلسلة نصية تصف الكائن Dir الذي استُدعي معه.
path
يعيد المسار المُمرّر إلى الباني new عند إنشائه للكائن Dir المعطى.
pos
يعيد موضع المؤشر الحالي في المجلد الذي استٌدعي معه.
seek
يذهب التابع seek إلى موضع محدد في المجلد الذي استٌدعي معه.
pos = integer
يحدِّد التابع pos عند استدعائه بالشكل pos = integer موضع المؤشر الحالي في المجلد.
read
يقرأ التابع read المدخلة التالية في المجلد الذي استُدعي معه ثم يعيده في سلسلة نصية.
rewind
يعيد التابع rewind ضبط موضع المؤشر الحالي في المجلد إلى بدايته.
tell
يعيد التابع tell الموضع الحالي في المجلد الذي استٌدعي معه. انظر أيضًا التابع seek.
to_path
يعيد المسار المُمرّر إلى الباني new عند إنشائه للكائن Dir المعطى.