الفرق بين المراجعتين ل"Ruby/Dir"
| سطر 92: | سطر 92: | ||
=== [[Ruby/Dir/seek|التابع seek]] === | === [[Ruby/Dir/seek|التابع seek]] === | ||
يذهب التابع <code>seek</code> إلى موضع محدد في الكائن من صنف <code>Dir</code> الذي استٌدعي معه. | يذهب التابع <code>seek</code> إلى موضع محدد في الكائن من صنف <code>Dir</code> الذي استٌدعي معه. | ||
| + | |||
| + | === [[Ruby/Dir/pos-3D|التعبير <code>pos =</code>]] === | ||
| + | التعبير <code>pos =</code> هو مرادف للتابع <code>[[uby/Dir/seek|seek]]</code>. بيد أنّه يعيد معامل الموضع (position parameter). | ||
| + | |||
| + | === [[Ruby/Dir/read|التابع read]] === | ||
| + | يقرأ التابع <code>read</code> المدخل الموالي في الكائن المجلدي (''dir'' object) الذي استُدعي معه ثم يعيده على شكل سلسلة نصية. وفي نهاية المجرى يعيد القيمة<code>nil</code> . | ||
| + | |||
| + | === [[Ruby/Dir/rewind|التابع rewind]] === | ||
| + | يعيد التابع <code>rewind</code> الموضع الراهن عند المدخل الأول. | ||
| + | |||
| + | === [[Ruby/Dir/tell|التابع tell]] === | ||
| + | يعيد التابع <code>tell</code> الموضع الحالي في الكائن من صنف <code>Dir</code> الذي استٌدعي معه. أنظر أيضًا التابع <code>[[uby/Dir/seek|seek]]</code>. | ||
| + | |||
| + | === [[Ruby/Dir/to path|التابع to_path]] === | ||
| + | يعيد التابع <code>to_path</code> المسار المُمرّر (في الوسيط <code>path</code>) إلى الباني <code>[[Ruby/Dir/new|new]]</code> على شكل سلسلة نصية. | ||
==مصادر<span> </span>== | ==مصادر<span> </span>== | ||
*[http://ruby-doc.org/core-2.5.1/Dir.html قسم الصنف Dir في توثيق روبي الرسمي.] | *[http://ruby-doc.org/core-2.5.1/Dir.html قسم الصنف Dir في توثيق روبي الرسمي.] | ||
مراجعة 17:53، 24 سبتمبر 2018
كائنات الصنفDir هي مجريات مجلدات (directory streams) في نظام الملفات الأساسي. فهي توفر مجموعة متنوعة من الطرق لعرض المجلدات ومحتوياتها. انظر أيضًا صفحة File.
يحتوي المجلد المستخدم في الأمثلة الموجودة في صفحات التوابع ملفين عاديين (config.h و main.rb) ، والمجلد الأب (..) ، والمجلد نفسه (.).
توابع الصنف العامة (Public Class Methods)
التابع []
يكافئ التابع Dir[] استدعاء Dir.glob([string,...], 0).
التابع chdir
يستبدل التابع chdir مجلد العمل (working directory) الحالي للعملية ويعيّن مكانه السلسلة النصية المعطاة.
التابع children
يعيد التابع children مصفوفة تحتوي جميع أسماء الملفات في المجلد المحدد باستثناء "." و "..". في حالة عدم وجود المجلد المحدد، فسيُطلق الخطأSystemCallError.
التابع chroot
يغير التابع chroot جذر (root) نظام الملفات الخاص بالعملية (process). فقط العمليات ذات الامتياز (privileged process) مُخوّلة لاستدعاء هذا التابع.
التابع delete
يمحو التابع delete المجلد المحدد، سيُطلق خطأ من صنف فرعي (subclass) من SystemCallError في حال لم يكن المجلد موجودًا.
التابع each_child
يستدعي التابع each_child الكتلة المعطاة على كل ملف من الملفات المحتواة في المجلد المحدد، باستثناء ".." و ".". حيث يمُمرّر أسماء تلك الملفات كوسائط للكتلة.
التابع delete
يمحو التابع delete المجلد المحدد، سيُطلق خطأ من صنف فرعي (subclass) من SystemCallError في حال لم يكن المجلد موجودًا.
التابع ?empty
يتحقق التابع ?empty مما إذا كان المجلد المعطى فارغًا.
التابع entries
يعيد التابع entries مصفوفة تحتوي جميع أسماء الملفات الموجودة في المجلد المحدد. في حال عدم وجود المجلد المحدد، فسيُطلق الخطأ SystemCallError.
التابع ?exist
يتحقق التابع ?exist مما إذا كان الملف المعطى مجلدًا.
التابع exists
هذا التابع صار متجاوزا، لا تستخدمه. انظر التابع ?exist.
التابع foreach
يستدعي التابع foreach الكتلة المعطاة على كل ملف من الملفات المحتواة في المجلد المحدد. حيث يمُمرّر أسماء تلك الملفات كوسائط للكتلة.
التابع getwd
يعيد التابع getwd مسار مجلد العمل (working directory) الحالي للعملية (process) على شكل سلسلة نصية.
التابع glob
يوسّع التابع glob الوسيط الممرّر pattern، والذي هو عبارة عن سلسلة نصية نمطية (pattern string) أو مصفوفة من السلاسل النصية النمطية، ويعيد مصفوفة تحتوي أسماء الملفات المتطابقة لذلك النمط.
التابع home
يعيد التابع home المجلد الرئيسي (home directory) للمستخدم الحالي أو للمستخدم المعطى في حال إعطائه.
التابع mkdir
ينشئ التابع mkdir مجلدًا جديدًا.
التابع new
يعيد التابع new كائنًا مجلديًا (directory object) جديدًا خاصًا بالمجلد المعطى.
التابع open
في حال عدم إعطاء كتلة، فإنّ التابع open هو مرادف لـ Dir::new. وفي حالة إعطاء كتلة، فسيُمرّر إليها aDirكمعامل.
التابع pwd
يعيد التابع pwd مسار مجلد العمل (working directory) الحالي للعملية (process) على شكل سلسلة نصية.
التابع rmdir
يمحو التابع rmdir المجلد المحدد، سيُطلق خطأ من صنف فرعي (subclass) من SystemCallError في حال لم يكن المجلد فارغًا .
التابع unlink
يمحو التابع unlink المجلد المحدد، سيُطلق خطأ من صنف فرعي (subclass) من SystemCallError في حال لم يكن المجلد فارغًا.
توابع الكائن العامة (Public Instance Methods)
التابع close
يغلق التابع close مجرى المجلد (directory stream)، استدعاء هذا التابع على على كائن Dir مغلق صار يُتجاهل منذ روبي 2.3.
التابع each
يستدعي التابع each الكتلة المعطاة على كل ملف من الملفات المحتواة في المجلد المحدد. حيث يمُمرّر أسماء تلك الملفات كوسائط للكتلة.
التابع fileno
يعيد التابع fileno عددًا صحيحًا يمثل واصف الملف العددي (numeric file descriptor) المُستخدم في الكائن من صنف Dir الذي استُدعي معه.
التابع inspect
يعيد التابع inspect سلسلة نصية تصف الكائن (من صنف Dir) الذي استُدعي معه.
التابع path
يعيد التابع path المسار المُمرّر إلى الباني new على شكل سلسلة نصية.
التابع pos
يعيد التابع pos الموضع الحالي في الكائن من صنف Dir الذي استٌدعي معه. أنظر أيضًا التابع seek.
التابع seek
يذهب التابع seek إلى موضع محدد في الكائن من صنف Dir الذي استٌدعي معه.
التعبير pos =
التعبير pos = هو مرادف للتابع seek. بيد أنّه يعيد معامل الموضع (position parameter).
التابع read
يقرأ التابع read المدخل الموالي في الكائن المجلدي (dir object) الذي استُدعي معه ثم يعيده على شكل سلسلة نصية. وفي نهاية المجرى يعيد القيمةnil .
التابع rewind
يعيد التابع rewind الموضع الراهن عند المدخل الأول.
التابع tell
يعيد التابع tell الموضع الحالي في الكائن من صنف Dir الذي استٌدعي معه. أنظر أيضًا التابع seek.
التابع to_path
يعيد التابع to_path المسار المُمرّر (في الوسيط path) إلى الباني new على شكل سلسلة نصية.