نتائج البحث

(PHP 4, PHP 5, PHP 7) يرجع التابع Directory::rewind()‎ مؤشِّر مجرى المجلَّد إلى موقع بداية المجلَّد. الوصف public void Directory::rewind ([ resource $dir_handle ] ) يشبه هذا التابع تمامًا الدالة rewinddir()‎ باستثناء أنَّ القيمة الافتراضيَّة للمعامل dir_handle هي ‎$this. مصادر صفحة التابع Directory::rewind في توثيق PHP الرسمي.

(PHP 4, PHP 5, PHP 7) يغلق التابع Directory::close()‎ مجلَّدًا مفتوحًا. الوصف public void Directory::close ([ resource $dir_handle ] ) يشبه هذا التابع تمامًا الدالة closedir()‎ باستثناء أنَّ القيمة الافتراضيَّة للمعامل dir_handle هي ‎$this. مصادر صفحة التابع Directory::close في توثيق PHP الرسمي.

(PHP 4, PHP 5, PHP 7) يقرأ التابع Directory::read()‎ عنصرًا واحدًا من مقبض المجلَّد ويعيده. الوصف public string Directory::read ([ resource $dir_handle ] ) يشبه هذا التابع تمامًا الدالة readdir()‎ باستثناء أنَّ القيمة الافتراضيَّة للمعامل dir_handle هي ‎$this. مصادر صفحة التابع Directory::read في توثيق PHP الرسمي.

(PHP 4, PHP 5, PHP 7) مقدمة تُنشأ نُسخ (instances) الصنف Directory باستدعاء الدالة dir()‎ وليس باستعمال الكلمة المفتاحية new. ملخص الصنف Directory { // الخاصِّيات public string $path ; public resource $handle ; // التوابع public void close ([ resource $dir_handle ] ) public string read ([ resource $dir_handle ] ) public void rewind ([ resource $dir_handle ] ...

(PHP 4, PHP 5, PHP 7) تعيد الدالة dir()‎ نسخةً (instance) من الصنف Directory. الوصف Directory dir ( string $directory [, resource $context ] ) تملك هذه الدالة آلية شبه كائنيَّة التوجه لقراءة المجلَّد. سيُفتح المجلد directory المعطى. المعاملات directory مسار المجلَّد المراد فتحه. context ملاحظة: أُضيف دعم المحتوى منذ إصدار PHP 5.0.0. راجع قسم المجرى (stream) للمزيد من الشرح عن المحتوى (context). القيم المعادة تُعاد نسخةٌ من الصنف Directory عند نجاح العمليَّة، أو القيمة NULL إن كان هنالك خطأ في ...

الثوابت المعرَّفة مسبقًا الثوابت المعرَّفة مسبقًا الخاصَّة بهذا الملحق. chdir()‎ تغيِّر مجلَّد PHP الحالي إلى مجلَّد آخر معطى. chroot()‎ تغيِّر مجلَّد الجذر (root directory) الحالي. closedir()‎ تغلق مجلَّدًا مفتوحًا. dir()‎ تعيد نسخةً (instance) من الصنف Directory. getcwd()‎ تعيد مجلَّد العمل الحالي. opendir()‎ تفتح مجلَّدًا محدَّدًا. readdir()‎ تقرأ عنصرًا واحدًا من محتويات المجلَّد وتعيده. rewinddir()‎ ترجع مؤشِّر مجرى المجلَّد إلى موقع بداية المجلَّد. scandir()‎ تعيد أسماء جميع الملفات والمجلَّدات الموجودة في مجلَّد محدَّد. الصنف Directory تُنشأ نُسخ (instances) الصنف Directory باستدعاء ...

(PHP 4 >= 4.0.5, PHP 5, PHP 7) تغيِّر الدالة chroot()‎ مجلَّد الجذر (root directory) الحالي. الوصف bool chroot ( string $directory ) تغيِّر هذه الدالة مجلَّد الجذر للعمليَّة الحالية إلى المجلَّد directory المعطى، وتغيِّر مجلَّد العمل الحالي إلى /. هذه الدالة متاحةٌ فقط على أنظمة غنو (GNU)، وأنظمة BSD، وعند استعمال CLI أو CGI أو SAPI المضمَّنة. تتطلَّب هذه الدالة أيضًا صلاحيات مدير النظام (المستخدم الجذر، root) لتنفيذ العمليَّة. المعاملات directory مسار المجلَّد المراد تغيير المجلَّد الجذر إليه. القيم المعادة ...

(PHP 4, PHP 5, PHP 7) تعيد الدالة scandir()‎ أسماء جميع الملفات والمجلَّدات الموجودة في مجلَّد محدَّد. الوصف array scandir ( string $directory [, int $sorting_order = SCANDIR_SORT_ASCENDING [, resource $context ]] ) تعيد هذه الدالة مصفوفةً تحتوي على أسماء الملفات والمجلَّدات الموجودة في المجلَّد directory المعطى. المعاملات directory المجلَّد المراد مسح جميع محتوياته وإعادتها. sorting_order طريقة ترتيب الناتج الافتراضيَّة هي وفقًا للحروف الهجائية بشكل تصاعدي (أي عندما لا تمرَّر قيمة للمعامل). إن كانت قيمة هذا المعامل هي SCANDIR_SORT_DESCENDING، فستكون طريقة ...

(PHP 4, PHP 5, PHP 7) تغيِّر الدالة chdir()‎ مجلَّد PHP الحالي إلى مجلَّد آخر معطى. الوصف bool chdir ( string $directory ) تغيِّر هذه الدالة مجلَّد PHP الحالي إلى المجلَّد directory المعطى. المعاملات directory المجلَّد الحالي الجديد. القيم المعادة تُعاد القيمة TRUE عند نجاح العمليَّة، والقيمة FALSE خلاف ذلك. الأخطاء والاستثناءات سيُصدر خطأ من المستوى E_WARNING عند فشل العمليَّة. أمثلة المثال 1: استعمال الدالة chdir()‎ <?php // معرفة المجلَّد الحالي echo getcwd() . "\n"; chdir('public_html'); // معرفة المجلَّد الحالي بعد تغييره echo getcwd() . "\n"; ?> سيُظهر ...

(PHP 4 >= 4.1.0, PHP 5, PHP 7) تعيد الدالة disk_total_space()‎ المساحة الكلِّيَّة لنظام الملفات أو أحد الأقسام (disk partition). الوصف float disk_total_space ( string $directory ) تعيد هذه الدالة عدد البايتات الكلِّيَّة لنظام الملفات أو أحد أقسام القرص الصلب بعد تمرير السلسلة النصيَّة directory التي تُمثِّل مسارًا للقسم أو حرفًا للقرص. المعاملات directory مسار القسم أو حرف القرص المُراد معرفة مساحته الكلِّيَّة. القيم المعادة يُعاد عدد عشري (float) يمثِّل المساحة الكلِّيَّة بواحدة البايت، أو تُعاد القيمة FALSE عند فشل العمليَّة. ...

(PHP 4 >= 4.1.0, PHP 5, PHP 7) تعيد الدالة disk_free_space()‎ المساحة المتوافرة (المتاحة) على نظام الملفات أو أحد الأقسام (disk partition). الوصف float disk_free_space ( string $directory ) تعيد هذه الدالة عدد البايتات المتاحة على نظام الملفات أو أحد أقسام القرص الصلب بعد تمرير السلسلة النصيَّة directory التي تُمثِّل مسارًا للقسم أو حرفًا للقرص. المعاملات directory مسار القسم أو حرف القرص المراد معرفة مساحته المتاحة. ملاحظة: إن أعُطي اسم ملفٍ عوضًا عن المسار أو حرف القرص، فسيكون سلوك هذه الدالة ...

(PHP 4, PHP 5, PHP 7) تُعيد الدالة get_declared_classes()‎ مصفوفةً فيها أسماء الأصناف المُصرّح عنها. الوصف array get_declared_classes ( void ) تحصل الدالة get_declared_classes()‎  على الأصناف المُصرّح عنها. المعاملات لا تملك الدالة get_declared_classes()‎ أيّة معاملات. القيم المعادة تُعيد الدالة get_declared_classes()‎ مصفوفة بأسماء الأصناف المُصرّح عنها في السكربت الحالي. ملاحظة: يمكن أن توجد أصناف إضافية في PHP  اعتمادًا على الإضافات المجمّعة (compiled) والمحملة إليها. وهذا يعني أنك لن تكون قادرًا على استخدام أسماء هذه الأصناف في تعريف أصنافك الخاصّة. ستجد قائمة بالأصناف ...

(PHP 4, PHP 5, PHP 7) تتحقَّق الدالة is_dir()‎ إن كان مسار الملف أو المجلَّد المُمرَّر إليها مجلَّدًا أم لا. الوصف bool is_dir ( string $filename ) تتحقَّق هذه الدالة فيما إذا كان الملف filename هو مجلَّد. المعاملات filename مسار الملف المراد التحقُّق منه. إن كان المعامل filename مسارًا نسبيًّا، فسيُتحقَّق منه نسبةً إلى مجلَّد العمل الحالي. إن كان المعامل filename وصلةً رمزيَّة أو صلبة، فسيُستبين المسار الذي تُشير إليه تلك الوصلة حينئذٍ ويُتحقَّق منه. إن كان الوضع الآمن أو  الخيار ...

(PHP 4, PHP 5, PHP 7) تفتح الدالة opendir()‎ مجلَّدًا محدَّدًا. الوصف resource opendir ( string $path [, resource $context ] ) تفتح هذه الدالة المجلَّد ذي المسار path ثمَّ تعيد مقبضًا له يمكن أن يُستعمل لاحقًا مع الدالة closedir()‎ والدالة readdir()‎ والدالة rewinddir()‎. المعاملات path مسار المجلَّد المُراد فتحه. context راجع قسم المجرى (stream) للمزيد من الشرح عن المعامل context. القيم المعادة يُعاد مورد مقبض المجلَّد عند نجاح العمليَّة، أو القيمة FALSE عند فشلها. إن كان المسار path خطأً ولا ...

مقدمة يوفّر Laravel تجريدًا قويًا لنظام الملفات بفضل الحزمة Flysystem. يوفّر تضمين أنظمة الملفات في Laravel مشغّلات سهلة الاستعمال للتعامل مع الأنظمة المحلية و Amazon S3 والتخزين السحابي Rackspace، بل من السهل جدًا تغيير خيارات التخزين إذ تبقى وصلة API نفسها مع كل الأنظمة. الضبط يوجد ملف ضبط نظام الملفات في config/filesystems.php. يمكنك في هذا الملف ضبط كل الأقراص "disks". يمثّل كل قرص مشغّل تخزين ومكان تخزين خاص. يحتوي الملف على أمثلة ضبط لكل مشغّل مدعوم. لذا غيّر الملف حسب ...

الثابت هو معرّف (اسم) لقيمة بسيطة، وكما هو واضح من الاسم فإنّ هذه القيمة غير قابلة للتبديل أثناء تنفيذ الشيفرة (باستثناء الثوابت السحرية والتي لا تعدّ ثوابت في الواقع). الثابت حساس لحالة الأحرف ومن الشائع استخدام الأحرف الكبيرة في تسمية الثوابت. تتبع الثوابت نفس القواعد المتّبعة للتسمية في PHP، فاسم الثابت الصحيح يبدأ بحرف أو بشرطة سفلية، متبوعًا بعدد غير محدّد من الأحرف والأرقام والشرطات السفلية. ولو أردنا استخدام التعابير النمطية (Regular Expressions) للتعبير عن اسم المتغير فسيكون كالتالي: [a-zA-Z_\x7f-\xff][a-zA-Z0-9_\x7f-\xff]* ...

الثابت هو معرّف (اسم) لقيمة بسيطة، وكما هو واضح من الاسم فإنّ هذه القيمة غير قابلة للتبديل أثناء تنفيذ الشيفرة (باستثناء الثوابت السحرية والتي لا تعدّ ثوابت في الواقع). الثابت حساس لحالة الأحرف ومن الشائع استخدام الأحرف الكبيرة في تسمية الثوابت. تتبع الثوابت نفس القواعد المتّبعة للتسمية في PHP، فاسم الثابت الصحيح يبدأ بحرف أو بشرطة سفلية، متبوعًا بعدد غير محدّد من الأحرف والأرقام والشرطات السفلية. ولو أردنا استخدام التعابير النمطية (Regular Expressions) للتعبير عن اسم المتغير فسيكون كالتالي: [a-zA-Z_\x7f-\xff][a-zA-Z0-9_\x7f-\xff]* ...

ملف الإعدادات يُقرأ ملف الإعدادات (php.ini)  عندما تبدأ اللغة بالعمل، أما الإصدارات الخاصة بالمخدّمات فإنّ عملية القراءة تحدث عندما يبدأ المخدّم بالعمل، وتبدأ هذه العملية في إصدارات CGI و CLI عند كل طلب invocation. يجري البحث عن ملف php.ini في الأماكن التالية (بنفس الترتيب التالي): موقع وحدة SAPI المحدّد (موجّه PHPIniDir في Apache 2، خيار سطر الأوامر ‎-c في CGI و CLI، المعامل php_ini في NASPI، متغير البيئة PHP_INI_PATH في THTTPD). متغيّر البيئة التابع لـ PHPRC. قبل الإصدار 5.2.0، كانت ...

ملف الإعدادات يُقرأ ملف الإعدادات (php.ini)  عندما تبدأ اللغة بالعمل، أما الإصدارات الخاصة بالمخدّمات فإنّ عملية القراءة تحدث عندما يبدأ المخدّم بالعمل، وتبدأ هذه العملية في إصدارات CGI و CLI عند كل طلب invocation. يجري البحث عن ملف php.ini في الأماكن التالية (بنفس الترتيب التالي): موقع وحدة SAPI المحدّد (موجّه PHPIniDir في Apache 2، خيار سطر الأوامر ‎-c في CGI و CLI، المعامل php_ini في NASPI، متغير البيئة PHP_INI_PATH في THTTPD). متغيّر البيئة التابع لـ PHPRC. قبل الإصدار 5.2.0، كانت ...

يتحقق التابع directory?‎ إن كان ملفٌ ما مجلَّدًا أو وصلةً رمزيًّةً تشير إلى مجلدٍ. البنية العامة directory?(file_name) → true or false المعاملات file_name اسم الملف المراد التحقق منه. يمكن أن يكون كائنًا من النوع IO. القيمة المعادة تعاد القيمة true إن كان ملفٌ ما مجلَّدًا أو وصلةً رمزيًّةً تشير إلى مجلدٍ. خلا ذلك، تعاد القيمة false. أمثلة مثال على استعمال التابع directory?‎: File.directory?(".") انظر أيضا التابع blockdev?‎: يتحقق إن كان ملفٌ ما هو جهاز كتلي (block device). التابع chardev?‎: يتحقق إن كان ملفٌ ما هو جهاز ...

يتحقق التابع directory?‎ إن كان ملفٌ ما مجلَّدًا أو وصلةً رمزيًّةً تشير إلى مجلدٍ. البنية العامة directory?(file_name) → true or false المعاملات file_name اسم الملف المراد التحقق منه. يمكن أن يكون كائنًا من النوع IO. القيمة المعادة تعاد القيمة true إن كان ملفٌ ما مجلَّدًا أو وصلةً رمزيًّةً تشير إلى مجلدٍ. خلا ذلك، تعاد القيمة false. أمثلة مثال على استعمال التابع directory?‎: File.directory?(".") انظر أيضا التابع zero?‎: يتحقق إن كان ملفٌ ما موجودًا وخاويًا (صفر الحجم). التابع executable?‎: يتحقق إن كان ...

يتحقق التابع directory?‎ إن كان ملفٌ ما مجلَّدًا أو وصلةً رمزيًّةً تشير إلى مجلدٍ. البنية العامة directory?(file_name) → true or false المعاملات file_name سلسلة نصية أو كائن من النوع IO يمثِّل الملف المراد التحقق منه. القيمة المعادة تعاد القيمة true إن كان ملفٌ ما مجلَّدًا أو وصلةً رمزيًّةً تشير إلى مجلدٍ. خلا ذلك، تعاد القيمة false. أمثلة مثال على استعمال التابع directory?‎: File.directory?(".") انظر أيضًا التابع executable?‎: يتحقق إن كان ملفٌ ما قابلًا للتنفيذ من طرف المعرِّف الفعلي للمستخدم المالك والمجموعة المالكة للعملية الحالية. التابع executable_real?‎: يتحقق إن كان ...

يعيد التابع home المجلد الرئيسي (home directory) للمستخدم الحالي أو للمستخدم المعطى في حال إعطائه. البنية العامة home() → "/home/me" home("root") → "/root" المعاملات root يحدد المستخدم المراد الحصول على مجلده الرئيسي. القيمة المعادة يعاد المجلد الرئيسي (home directory) للمستخدم الحالي أو للمستخدم المعطى في حال إعطائه. انظر أيضًا التابع getwd: يعيد مسار مجلد العمل (working directory) الحالي للعملية (process) على شكل سلسلة نصية.  مصادر قسم التابع home في الصنف Dir في توثيق روبي الرسمي.

يعيد التابع pwd مسار مجلد العمل (working directory) الحالي للعملية. البنية العامة pwd → string القيمة المعادة تُعاد سلسلة نصية تحوي مسار مجلد العمل الحالي للعملية. أمثلة مثال عن استخدام التابع pwd: Dir.chdir("/tmp") #=> 0 Dir.getwd #=> "/tmp" Dir.pwd #=> "/tmp" انظر أيضًا التابع chdir: يغيِّر مجلد العمل (working directory) الحالي للعملية إلى مجلد آخر. التابع getwd: يعيد مسار ...

(PHP 4, PHP 5, PHP 7) ترجع الدالة rewinddir()‎ مؤشِّر مجرى المجلَّد إلى موقع بداية المجلَّد. الوصف void rewinddir ([ resource $dir_handle ] ) ترجع هذه الدالة موقع المؤشِّر للمجلَّد الذي يشير إليه المورد dir_handle إلى بداية مجرى المجلَّد. المعاملات dir_handle مورد مقبض المجلَّد الذي يشير إلى مجلَّد فُتح بطريقة صحيحة باستعمال الدالة opendir()‎. إن لم يعطَ هذا المعامل (أي لم يحدَّد المجلَّد)، فسيكون آخر مجلَّد فُتح باستعمال الدالة opendir()‎. القيم المعادة تُعاد القيمة NULL عند نجاح العمليَّة. خلا ذلك، تُعاد ...

(PHP 4, PHP 5, PHP 7) تعيد الدالة getcwd()‎ مجلَّد العمل الحالي. الوصف string getcwd ( void ) تعيد هذه الدالة مجلَّد العمل الحالي. القيم المعادة يُعاد مسار مجلَّد العمل الحالي عند نجاح العمليَّة، أو القيمة FALSE عند فشلها. ستعيد الدالة getcwd()‎ في الأنظمة الشبيهة بيونكس القيمة FASLE إن كان أيُّ مجلِّد أبٍ للمجلَّد المُعاد لا يملك أذنًا للقراءة حتى لو كان ذلك المجلَّد -مجلَّد العمل الحالي- يملك ذلك. راجع صفحة الدالة chmod()‎ للمزيد من التفاصيل حول الأذونات. أمثلة المثال 1: ...

(PHP 4, PHP 5, PHP 7) تغلق الدالة closedir()‎ مجلَّدًا مفتوحًا. الوصف void closedir ([ resource $dir_handle ] ) تغلق هذه الدالة المجلَّد المفتوح الذي يشير إليه المورد dir_handle. يجب أن يكون المجلَّد قد فُتح مسبقًا باستعمال الدالة opendir()‎. المعاملات dir_handle مورد مقبض المجلَّد المراد إغلاقه، ويشير إلى مجلَّد فُتح بطريقة صحيحة باستعمال الدالة opendir()‎. إن لم يعطَ هذا المعامل أي لم يحدَّد المجلَّد المراد إغلاقه، فسيُغلق آخر مجلَّد فُتح باستعمال الدالة opendir()‎. أمثلة المثال 1: استعمال الدالة closedir()‎ <?php $dir = ...

(PHP 4, PHP 5, PHP 7) تقرأ الدالة readdir()‎ عنصرًا واحدًا من محتويات المجلَّد وتعيده. الوصف string readdir ([ resource $dir_handle ] ) تعيد هذه الدالة اسم العنصر التالي الموجود في المجلَّد. تُعاد العناصر بالترتيب الذي خُزَّنت فيه بوساطة نظام الملفات. المعاملات dir_handle مورد مقبض المجلَّد المراد القراءة منه والذي يشير إلى مجلَّد فُتح بطريقة صحيحة باستعمال الدالة opendir()‎. إن لم يعطَ هذا المعامل أي لم يحدَّد المجلَّد، فسيُقرأ من آخر مجلَّد فُتح باستعمال الدالة opendir()‎. القيم المعادة يُعاد اسم عنصر ...

كائنات الصنف Dir هي مجاري مجلدات (directory streams) تمثِّل الجلدات في نظام الملفات الأساسي لنظام التشغيل. فهي توفر طرائق متعددة لعرض المجلدات ومحتوياتها. انظر أيضًا صفحة الصنف File لمزيد من المعلومات. يحوي المجلد المستخدم في الأمثلة الموجودة في صفحات التوابع ملفين عاديين هما: config.h و main.rb، بالإضافة إلى المجلد الأب (..) ، والمجلد نفسه (.). توابع الصنف العامة (Public Class Methods) المعامل [] يكافئ استدعاء Dir.glob([string,...], 0)‎.  chdir‎ يغيِّر مجلد العمل (working directory) الحالي للعملية الحالية إلى مجلَّدٍ محدَّدٍ. children ...

يعيد التابع getwd مسار مجلد العمل (working directory) الحالي للعملية الحالية. البنية العامة getwd → string القيمة المعادة تُعاد سلسلة نصية تحوي مسار مجلد العمل الحالي للعملية. أمثلة مثال عن استخدام التابع getwd: Dir.chdir("/tmp") #=> 0 Dir.getwd #=> "/tmp" Dir.pwd #=> "/tmp" انظر أيضًا التابع chdir: يغيِّر مجلد العمل (working directory) الحالي للعملية إلى مجلد آخر محدَّد. مصادر ...

يعيد التابع new كائنًا مجلديًا (directory object) جديدًا خاصًا بالمجلد المعطى. البنية العامة new( string ) → aDir new( string, encoding: enc ) → aDir المعاملات string  اسم المجلد المعطى. encoding يحدِّد هذا الوسيط الاختياري ترميز المجلد. وفي حال عدم إعطائه، سيُستخدم ترميز نظام الملفات. القيمة المعادة يعاد كائنٌ مجلديٌ (directory object) جديدٌ خاص بالمجلد string المعطى. انظر أيضًا التابع open: يفتح مجلدًا محدَّدًا ثمَّ يعيد كائنًا يشير إليه. مصادر قسم التابع new في الصنف Dir في توثيق روبي الرسمي.

التابع Path.mkdir في بايثون يُنشئ هذا التابع مجلّدًا في المسار المُعطى بالخصائص التي يتم تحديدها في باقي الوسطاء. Create a new directory at this given path. If mode is given, it is combined with the process’ umask value to determine the file mode and access flags. If the path already exists, FileExistsError is raised. If parents is true, any missing parents of this path are created as needed; they are created with the default permissions without taking mode into account ...

التابع Path.home يعيد كائن مسار جديدًا يمثّل المسار الرئيسي (home directory) للمستخدم (بشكل مشابه للتابع os.path.expanduser مع الوسيط '~') وهو تابع جديد في النسخة 3.5. البنية العامة Path.home() المعاملات بدون معاملات القيمة المعادة يعيد كائن مسار جديدًا يمثّل المسار الرئيسي (home directory) للمستخدم. أمثلة يبين المثال التالي طريقة استخدام التابع: >>> from pathlib import Path >>> Path.home() WindowsPath('D:/Downloads/WinPython/settings') >>> import os >>> os.path.expanduser('~') 'D:\\Downloads\\WinPython\\settings' انظر أيضًا التابع os.path.expanduser في الوحدة os. مصادر قسم الوحدة pathlib في توثيق بايثون الرسمي.

أمثلة يوضح المثال التالي الطريقة المُثلى للاستفادة من توابع الكشف في الصنف stat: import os, sys from stat import * def walktree(top, callback): '''recursively descend the directory tree rooted at top, calling the callback function for each regular file''' for f in os.listdir(top): pathname = os.path.join(top, f) mode = os.stat(pathname).st_mode ...

تمثل الخاصية MatchResult.destructured‎ نسخةً من الصنف Destructured توفّر مكونات عملية الإسناد بالتفكيك (destructuring assignment) التي تطبق على قيم المجموعة المُطابقة. تطابق الدالة component1 قيمة المجموعة الأولى، وتطابق الدالة component2 قيمة المجموعة الثانية، وهلم جرًا. البنية العامة open val destructured: Destructured القيمة المعادة تعاد نسخةٌ من الصنف Destructured. أمثلة ينشِئ التابع Regex()‎ في الشيفرة التالية تعبيرًا نمطيًا باسم regex لتفكيك مسارات الملفات إلى ثلاث مُركّبات: المجلد (directory) واسم الملف (fileName) والامتداد (extension)، ثم نعرّف سلسلة نصية باسم fullPath تحتوي مسار أحد الملفات، ثم نستخرج من fullPath مجموعات النتائج عبر استدعاء الدالة ...

يعرِّف التابع ftype نوع الملف المعطى. البنية العامة ftype(file_name) → string المعاملات file_name اسم الملف المراد تحديد نوعه. القيمة المعادة تعاد سلسلة نصية تحدَّد نوع الملف file_name. تكون هذه السلسلة النصية المعادة إحدى السلاسل النصية التالية: "file''، أو "directory''، أو "characterSpecial''، أو "blockSpecial''، أو "fifo''، أو "link''، أو "socket''، أو "unknown''. أمثلة مثال على استعمال التابع ftype: File.ftype("testfile") #=> "file" File.ftype("/dev/tty") ...

يعرِّف التابع ftype نوع الملف الذي يشير إليه الكائن File::Stat المعطى. البنية العامة ftype → string القيمة المعادة تعاد سلسلة نصية تحدَّد نوع الملف الذي يشير إليه الكائن File::Stat المعطى. تكون هذه السلسلة النصية المعادة إحدى السلاسل النصية التالية: "file''، أو "directory''، أو "characterSpecial''، أو "blockSpecial''، أو "fifo''، أو "link''، أو "socket''، أو "unknown''. أمثلة مثال على استعمال التابع ftype: File.stat("/dev/tty").ftype #=> "characterSpecial" انظر أيضا التابع blockdev?‎: يتحقق إن كان ملفٌ ما هو جهاز كتلي (block device). التابع chardev?‎: يتحقق إن ...

يفتح التابع open مجلدًا محدَّدًا ثمَّ يعيد كائنًا يشير إليه. إن لم تمرَّر إليه كتلة، فهو مرادف للتابع Dir::new. أمَّا إن مُرِّرت إليه كتلة، فسيُمرّر إليها aDir (انظر فقرة البنية العامة) كمعامل. يُغلَق المجلد في بعد الانتهاء من تنفيذ الكتلة، ويعيد التابع Dir::open ناتج تنفيذ هذه الكتلة. البنية العامة open( string ) → aDir open( string, encoding: enc ) → aDir open( string ) {| aDir | block } → anObject open( string, encoding: enc ) {| aDir | block } → anObject ...

الاسم النوع الوصف DIRECTORY_SEPARATOR string PATH_SEPARATOR string فاصلة منقوطة في ويندوز، ونقطتان في غيره. SCANDIR_SORT_ASCENDING integer أصبح متاحٌ منذ إصدار PHP 5.4.0. SCANDIR_SORT_DESCENDING integer أصبح متاحٌ منذ إصدار PHP 5.4.0. SCANDIR_SORT_NONE integer أصبح متاحٌ منذ إصدار PHP 5.4.0. انظر أيضًا قسم التعامل مع المجلَّدات. قسم التعامل مع نظام الملفات. مصادر الصفحة constants في توثيق PHP الرسمي.

(PHP 4, PHP 5, PHP 7) تعدّ حلقات for النوع الأكثر تعقيدًا من الحلقات في PHP، وهي مشابهة لنظيرتها في لغة C، وتأخذ الصيغة التالية: for (expr1; expr2; expr3) statement ينفّذ التعبير expr1 مرة واحدة دون قيد أو شرط في بداية الحلقة، وينفّذ التعبير expr2 في بداية كل دورة، فإن كانت النتيجة هي TRUE فتستمر الحلقة في عملها وتنفّذ العبارات المضمّنة فيها، أما إن كانت النتيجة هي FALSE فتتوقف الحلقة عن العمل، أما التعبير expr3 فينفّذ في ...

(PHP 4, PHP 5, PHP 7) بنية if هي واحدة من أهم الميزات المتوفّرة في العديد من اللغات البرمجية، ومن ضمنها PHP. إذ تتيح تنفيذ أجزاء من الشيفرة اعتمادًا على شروط معينة. تعتمد PHP بنية if المعتمدة في لغة C: if (expr) statement تُحسب التعابير -كما ورد في الفصل المتعلّق بالتعابير في هذا الدليل- إلى قيمة منطقية (Boolean)، فإن كانت نتيجة الحساب هي TRUE تنفذ PHP العبارة، وإن كانت نتيجة الحساب هي FALSE تتجاهل اللغة ذلك التعبير. يمكن الحصول ...

(PHP 4, PHP 5, PHP 7) تعدّ حلقات for النوع الأكثر تعقيدًا من الحلقات في PHP، وهي مشابهة لنظيرتها في لغة C، وتأخذ الصيغة التالية: for (expr1; expr2; expr3) statement ينفّذ التعبير expr1 مرة واحدة دون قيد أو شرط في بداية الحلقة، وينفّذ التعبير expr2 في بداية كل دورة، فإن كانت النتيجة هي TRUE فتستمر الحلقة في عملها وتنفّذ العبارات المضمّنة فيها، أما إن كانت النتيجة هي FALSE فتتوقف الحلقة عن العمل، أما التعبير expr3 فينفّذ في ...

(PHP 4, PHP 5, PHP 7) بنية if هي واحدة من أهم الميزات المتوفّرة في العديد من اللغات البرمجية، ومن ضمنها PHP. إذ تتيح تنفيذ أجزاء من الشيفرة اعتمادًا على شروط معينة. تعتمد PHP بنية if المعتمدة في لغة C: if (expr) statement تُحسب التعابير -كما ورد في الفصل المتعلّق بالتعابير في هذا الدليل- إلى قيمة منطقية (Boolean)، فإن كانت نتيجة الحساب هي TRUE تنفذ PHP العبارة، وإن كانت نتيجة الحساب هي FALSE تتجاهل اللغة ذلك التعبير. يمكن الحصول ...

يغيِّر التابع chdir‎ مجلد العمل (working directory) الحالي للعملية الحالية إلى مجلَّدٍ محدَّدٍ. عند استدعائه بدون تمرير وسيط، فسيغيِّر مجلد العمل إلى قيمة متغير البيئة HOME أو LOGDIR.SystemCallError (وربما Errno::ENOENT) إذا كان المجلد المُستهدَف غير موجود. في حال تمرير كتلة برمجية إلى التابع، فسيُمرّر إليها اسم المجلد الحالي الجديد، وستنفّذ الكتلة على اعتباره المجلد الحالي. بعد تنفيذ الكتلة والخروج منها، سيُستعَاد مجلد العمل الأصلي آنذاك. وتكون القيمة المعادة للتابع chdir مساويةً لقيمة الكتلة. يمكن أن تتشعّب الكتل chdir، ولكن سيُطلَق ...

عام استخدام أمر select البُنية اللغوية لأمر select تشبه بُنية حلقة for: select WORD [in LIST]; do RESPECTIVE-COMMANDS; done ويُستخدم أمر select من أجل إنشاء قوائم بسهولة عبر اتباع ما يلي: تُوسّع القائمة LIST مولِّدة قائمة من العناصر ويطبع التوسع في خطأ قياسي (standard error)، كما يُسبق كل عنصر من القائمة برقم. وإن لم تكن in LIST موجودة فتُطبع المعامِلات الموضعية كما لو تم تحديد @$ in. أيضًا، تُطبع قائمة LIST مرة واحدة فقط. يُطبع محث PS3 عند طباعة كل العناصر، ...

يحذف التابع delete‎ مجلدًا محدَّدًا. سيُطلق خطأ من صنف فرعي من SystemCallError في حال لم يكن المجلد المراد حذفه موجودًا. البنية العامة delete( string ) → 0 المعاملات string اسم المجلد المُراد حذفه. انظر أيضًا التابع chdir‎ : يغيِّر مجلد العمل (working directory) الحالي للعملية إلى مجلد محدَّد. التابع rmdir‎ :يحذف مجلدًا محدَّدًا.  مصادر قسم التابع delete في الصنف Dir في توثيق روبي الرسمي.

يغير التابع chroot المجلد الجذر (root) لنظام الملفات الخاص بالعملية الحالية. العمليات التي تمتلك الصلاحيات الكافية هي العمليات المُخوّلة لاستدعاء هذا التابع. التابع غير متوفر على جميع أنظمة التشغيل. البنية العامة chroot( string ) → 0 المعاملات string المجلد الجذر الجديد لنظام الملفات الخاص بالعملية الحالية. انظر أيضًا التابع chdir‎: يغيِّر مجلد العمل (working directory) الحالي للعملية الحالية إلى مجلَّدٍ محدَّدٍ . مصادر قسم التابع chdir في الصنف Dir في توثيق روبي الرسمي.

يُطلق الاستثناء IOError عند فشل عملية إدخال/إخراج (IO operation) في روبي. File.open("/etc/hosts") {|f| f << "example"} #=> IOError: not opened for writing File.open("/etc/hosts") {|f| f.close; f.read } #=> IOError: closed stream تذكر أنَّ فشل بعض عمليات الإدخال/الإخراج قد يؤدي إلى إطلاق الاستثناء SystemCallError، وهذا الاستثناء ليس متفرع من الصنف IOError. File.open("does/not/exist") #=> Errno::ENOENT: No such file or directory - does/not/exist مصادر صفحة الصنف IOError في توثيق روبي الرسمي.

يكافئ المعامل []‎ الاستدعاء Dir.glob([string,...], 0)‎. البنية العامة Dir[ string [, string ...] [, base: path] ] → array القيمة المعادة تُعاد مصفوفة تحوي النتائج. أمثلة مثال عن استخدام المعامل []‎ مع المجلد testdir الذي يحتوي ملفين عاديين (الملف config.h والملف main.rb)، والمجلد الأب (..)، والمجلد نفسه (.): Dir["config.?"] #=> ["config.h"] انظر أيضًا التابع chdir‎: يستبدل التابع chdir‎ مجلد العمل (working directory) الحالي للعملية ويعيّن مكانه ...

يتحقق التابع pipe?‎ إن كان يدعم نظام التشغيل الحالي الأنابيب وكان الملف الذي يشير إليه الكائن File::Stat المعطى أنبوبًا. البنية العامة pipe? → true or false القيمة المعادة تعاد القيمة true إن كان يدعم نظام التشغيل الحالي الأنابيب وكان الملف الذي يشير إليه الكائن File::Stat المعطى أنبوبًا. خلا ذلك، تعاد القيمة false. انظر أيضًا التابع chardev?‎: يتحقق إن كان ملفٌ ما هو جهاز محرفي (character device). التابع directory?‎: يتحقق إن كان ملفٌ ما مجلَّدًا أو وصلةً رمزيًّةً تشير إلى مجلدٍ. التابع ...