نتائج البحث

(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?‎: يتحقق إن كان ملفٌ ما مجلَّدًا أو وصلةً رمزيًّةً تشير إلى مجلدٍ. التابع ...

يعيد التابع path المسار المُمرّر إلى الباني new عند إنشائه للكائن Dir المعطى. البنية العامة path → string or nil القيمة المعادة تُعاد سلسلة نصية تمثِّل المسار المُمرّر إلى الباني new الذي استعمل في إنشاء الكائن Dir المعطى. أمثلة مثال عن استخدام التابع path على المجلد testdir الذي يحوي ملفين عاديين (config.h و main.rb)، والمجلد الأب (..)، والمجلد نفسه (.): d = Dir.new("..") d.path #=> ".." انظر أيضًا التابع to_path: يعيد المسار المُمرّر (في الوسيط path) إلى الباني new على شكل سلسلة نصية.  التابع getwd: يعيد مسار ...

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

يعيد التابع to_path المسار المُمرّر إلى الباني new عند إنشائه للكائن Dir المعطى. البنية العامة to_path → string or nil القيمة المعادة تُعاد سلسلة نصية تمثِّل المسار المُمرّر إلى الباني new الذي استعمل في إنشاء الكائن Dir المعطى. أمثلة مثال عن استخدام التابع to_path على المجلد testdir الذي يحوي ملفين عاديين (config.h و main.rb)، والمجلد الأب (..)، والمجلد نفسه (.): d = Dir.new("..") d.path #=> ".." انظر أيضًا التابع getwd: يعيد مسار مجلد العمل (working directory) الحالي للعملية.  التابع path: يعيد المسار المُمرّر إلى الباني new عند ...

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

يتحقق التابع socket?‎ إن كان الملف الذي يشير إليه الكائن File::Stat المعطى مقبسًا. البنية العامة socket? → true or false القيمة المعادة تعاد القيمة true إن كان الملف الذي يشير إليه الكائن File::Stat المعطى مقبسًا، أو تعاد القيمة false إن لم يكن الملف مقبسًا أو لم يكن نظام التشغيل يدعم هذه الميزة. أمثلة مثال على استعمال التابع socket?‎: File.stat("testfile").socket? #=> false انظر أيضًا التابع directory?‎: يتحقق إن كان ملفٌ ما مجلَّدًا أو وصلةً رمزيًّةً تشير إلى مجلدٍ. التابع symlink?‎: يتحقق ...

ينشئ التابع mkdir مجلدًا جديدًا باسم محدَّد، مع تحديد أذوناته أيضًا. يمكن تعديل الأذونات بواسطة File::umask، ويتم تجاهلها في NT. إن لم يكن بالإمكان إنشاء المجلد، فسيُطلق الخطأ SystemCallError. راجع أيضًا مناقشة الأذونات في توثيق الصنف File. البنية العامة mkdir( string [, integer] ) → 0 المعاملات string  اسم المجلد الجديد المراد إنشاؤه. integer أذونات المجلد الجديد المراد إنشاؤه. أمثلة مثال عن استخدام التابع mkdir: Dir.mkdir(File.join(Dir.home, ".foo"), 0700) #=> 0 انظر أيضًا التابع chdir: يغيِّر مجلد العمل (working directory) الحالي ...

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

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

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

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

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

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

يتحقق التابع file?‎ إن كان الملف الذي يشير إليه الكائن File::Stat المعطى موجودًا وكان ملفًا طبيعيًّا (وليس جهازًا أو أنبوبًا أو مقبسًا ...إلخ.). البنية العامة file? → true or false القيمة المعادة تعاد القيمة true إن كان الملف الذي يشير إليه الكائن File::Stat المعطى موجودًا وكان ملفًا طبيعيًّا (وليس جهازًا أو أنبوبًا أو مقبسًا ...إلخ.). خلا ذلك، تعاد القيمة false. أمثلة مثال على استعمال التابع file?‎: File.stat("testfile").file? #=> true انظر أيضا التابع blockdev?‎: يتحقق إن كان ملفٌ ما هو جهاز ...

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

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

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

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

يعيد التابع readlink اسم الملف الذي تشير إليه الوصلة المعطاة. هذا التابع غير متاح على جميع المنصات. البنية العامة readlink(link_name) → file_name المعاملات link_name اسم الوصلة المراد معرفة الملف الذي تشير إليه. القيمة المعادة يعاد اسم الملف الذي تشير إليه الوصلة link_name. أمثلة مثال على استعمال التابع readlink: File.symlink("testfile", "link2test") #=> 0 File.readlink("link2test") #=> "testfile" انظر أيضا التابع absolute_path: يحول اسم مسار محدَّد إلى مسار مطلق. التابع directory?‎: ...

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

يعتبر الصنف SystemCallError الصنف الأب لكل أصناف الأخطاء منخفضة المستوى المرتبطة بنظام التشغيل. الأخطاء المتوفرة على نظام التشغيل الحالي هي أصناف فرعية من الصنف SystemCallErrorـ وهي مُعرّفة في الوحدة Errno. File.open("does/not/exist")‎ عند تنفيذ هذا السطر البرمجي، سيطلق استثناء بالشكل التالي: Errno::ENOENT: No such file or directory - does/not/exist‎ توابع الصنف العامة (Public Class Methods) === يتحقق إن كان الاستثناء الذي استُدعي معه كائنًا عامًا من الصنف SystemCallError، أو إن كان رقما الخطأ الخاصين بهذا الاستثناء والاستثناء الآخر المعطى متساويين. new ...

 التابع Path.cwd يعيد كائن مسار جديدًا يمثّل المسار الحالي (بشكل مشابه للتابع os.getcwd) البنية العامة Path.cwd() المعاملات بدون معاملات القيمة المعادة يعيد كائن مسار جديدًا يمثّل المسار الرئيسي (home directory) للمستخدم أمثلة يبين المثال التالي طريقة استخدام التابع: >>> from pathlib import Path >>> Path.cwd()#لاحظ أنه يمكن استدعاء التابع دون إنشاء كائن منه WindowsPath('D:/Downloads/WinPython/notebooks') >>> import os >>> os.getcwd()#تابع يقوم بنفس الوظيفة في وحدة نظام التشغيل 'D:\\Downloads\\WinPython\\notebooks' >>> os.chdir('C:\\Program Files (x86)')#تغيير مسار المجلد الرئيسي >>> Path.cwd() WindowsPath('C:/Program Files (x86)') انظر أيضًا التابع os.getcwd في الوحدة os يقوم بنفس ...

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

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

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

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

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

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

(PHP 4, PHP 5, PHP 7) تشبه عبارة switch سلسلةً من عبارات if مطبّقة على نفس التعبير. قد تحتاج في بعض الأحيان إلى مقارنة نفس المتغير (أو التعبير) مع قيم مختلفة (حالات cases)، وتنفيذ شيفرة مختلفة بالاعتماد على ذلك، وهذه هي وظيفة عبارة switch. ملاحظة: بخلاف بعض اللغات البرمجية، يمكن استخدام عبارة continue في switch وهي تعمل عمل العبارة break. إن كنت تستخدم switch داخل حلقة وأردت الانتقال إلى الدورة التالية في الحلقة التكرارية الخارجية، استخدم continue 2. ملاحظة: تؤدي ...

(PHP 4, PHP 5, PHP 7) تعمل عبارة include على تضمين ومعالجة الملف المحدّد. ينطبق التوثيق التالي على عبارة require. تُضمّن الملفات بالاعتماد على المسار المعطى للعبارة، وفي حال عدم تحديد المسار، تأخذ include المسار المحدد في include_path. إن لم يكن الملف موجودًا في include_path ستتحقّق include في المجلّد الذي يحتوي على الشيفرة التي أجرت الاستدعاء وفي مجلد العمل الحالي قبل أن تطلق خطأً. تطلق بنية include تحذيرًا إن لم تتمكن من العثور على الملف، وتختلف في ذلك عن require ...

(PHP 4, PHP 5, PHP 7) تنهي break تنفيذ حلقات for أو foreach أو while أو do-while أو بنية switch. تأخذ break معاملًا عدديًا اختياريًا يُحدّد من خلاله عدد البنى المتداخلة التي‏ يجب إيقاف تنفيذها. القيمة الافتراضية لهذا المعامل هي 1، والذي يعني إيقاف تنفيذ البنية الحالية فقط. <?php $arr = array('one', 'two', 'three', 'four', 'stop', 'five'); while (list(, $val) = each($arr)) { if ($val == 'stop') { break; /* يمكن أيضًا كتابة /* ...

(PHP 4, PHP 5, PHP 7) العبارة require مطابقة للعبارة include باستثناء أنّها تطلق خطأ من نوع E_COMPLE_ERROR في حال فشلها في جلب الملف. وبعبارة أخرى فإنها ستوقف عمل الشيفرة تمامًا، في حين أنّ include تطلق تحذيرًا (E_WARNING) والذي لا يؤدي إلى إيقاف الشيفرة عن العمل. راجع توثيق include لمعرفة طريقة عملها. مصادر صفحة require في توثيق PHP الرسمي.

يكون التعبير عن المتغيرات في PHP باستخدام علامة $ متبوعة باسم المتغير والذي يكون حساسًا لحالة الأحرف. تتبع المتغيرات نفس القواعد المتبّعة للتسمية في PHP. إذ يبدأ اسم المتغير الصحيح بحرف أو بشرطة سفلية متبوعة بعدد غير محدد من الحروف أو الأرقام أو الشرطات السفلية. ولو أردنا استخدام التعابير النمطية (Regular Expression) للتعبير عن اسم المتغير فسيكون كالتالي: '‎‎[a-zA-Z_\x7f-\xff][a-zA-Z0-9_\x7f-\xff]*‎‎'. ملاحظة: في هذا الدليل الحرف هو كل ما يقع ضمن النطاق a-z و A-Z والبايتات من 127 إلى 255 (0x7f-0xff). ملاحظة: ...

(PHP 4, PHP 5, PHP 7) تستخدم continue في الحلقات التكرارية لتجاوز ما يأتي بعدها في الحلقة التكرارية والاستمرار في تنفيذ الشيفرة حسب الشرط المعتمد في الحلقة ثم الانتقال إلى بداية الدورة التالية. تأخذ continue معاملًا عدديًّا اختياريًا يمكن من خلاله تحديد عدد الحلقات التكرارية المحيطة بها والتي يجب تجاوزها إلى النهاية. القيمة الافتراضية هي 1 والتي تعني الانتقال إلى نهاية الحلقة الحالية. ملاحظة: تعدّ عبارة switch في PHP من الحلقات التكرارية عند الحديث عن continue. تسلك continue سلوك break ...

يأخذ العامل (operator) قيمة واحدة أو أكثر (أو تعابير حسب اصطلاحات البرمجة) ويعطي قيمة أخرى (بحيث تتحول البنية نفسها إلى تعبير). يمكن تصنيف العوامل بحسب عدد القيم التي تأخذها، فالعوامل الأحادية Uanry تأخذ قيمة واحدة فقط مثل العامل (!) (معامل النفي المنطقي) أو (++) (معامل الزيادة). أما العوامل الثنائية فتأخذ قيمتين، وخير مثال عليها هو العوامل الحسابية المعروفة (+) الجمع، و (-) الطرح، إضافة إلى غالبية العوامل التي تقدّمها لغة PHP. وأخيرًا هناك معامل ثلاثي وحيد وهو ? : ويأخذ قيمًا ثلاثة، ...

(PHP 4, PHP 5, PHP 7) تستخدم بنية declare لتعيين موجّهات التنفيذ (execution directives) لكتلة من الشيفرة، وصيغة declare مشابهة لبنى التحكم في تدفق الشيفرة. الوصف declare (directive) statement يتيح الموجه تعيين سلوك كتلة (block). يمكن للغة في الوقت الحاضر أن تتعرف على ثلاثة أنواع من الموجهات فقط: موجه ticks (للمزيد من المعلومات حول موجه ticks انظر أدناه)، وموجه encoding (للمزيد من المعلومات حول موجه encoding انظر أدناه)، وموجه strict_types (للمزيد من المعلومات راجع قسم strict في ...

(PHP 4, PHP 5, PHP 7) تعيد تنفيذ البرنامج إلى الوحدة التي قامت بالاستدعاء، وسيستمر التنفيذ إلى التعبير الذي يلي تعبير الاستدعاء. إذا استدعيت عبارة return داخل الدالة فإنّها ستنهي تنفيذ الدالة على الفور وتعيد معاملها كقيمة لاستدعاء الدالة. تنهي return أيضًا تنفيذ عبارة eval()‎ أو ملف الشيفرة. إن استدعيت عبارة return من النطاق العام (global scope) فإنها تنهي عملية تنفيذ ذلك الملف. وإن كان ملف الشيفرة مضمنًا (included) أو مطلوبًا (required)، فإن التحكّم يعود إلى الملف المستدعي مرة أخرى. ...

المصفوفة في PHP هي خريطة (map) مرتّبة، والخريطة هي نوع ترتبط فيه القيم مع المفاتيح، ولها استخدامات عديدة، فيمكن التعامل معها كمصفوفة أو قائمة (vector) أو جدول hash (نوع من الخرائط) أو قاموس (dictionary) أو مجموعة (collection) أو مكدس (stack) أو طابور (queue) وغير ذلك، حتى أن قيم المصفوفة يمكن أن تكون مصفوفات أخرى، ممّا يسمح بإنشاء مصفوفات متعددة الأبعاد. لن نشرح جميع هذه الأنواع في هذا التوثيق، لكن ستجد مثالًا واحدًا على الأقل لكلٍ منها. الصياغة إنشاء المصفوفات باستخدام ...

(PHP 4, PHP 5, PHP 7) تقدّم بنية foreach طريقة سهلة للتنقل بين عناصر المصفوفات، وتعمل هذه البنية مع المصفوفات والكائنات فقط، ويؤدي استخدامها مع متغير ذي نوع بيانات مختلف أو متغير غير مهيئ إلى إطلاق خطأ. لهذه البنية صيغتان: foreach (array_expression as $value) statement foreach (array_expression as $key => $value) statement تنتقل الصيغة الأولى عبر المصفوفة بحسب التعبير المقدّم إليها (array_expression). وفي كل دورة تسند اللغة قيمة العنصر الحالي إلى المتغير ‎$value ويتقدّم المؤشر ...

تهيئة الكائن لإنشاء كائن جديد، استخدم التعبير البرمجي new لتهيئة كائن من صنفٍ ما (class): <?php class foo { function do_foo() { echo "Doing foo."; } } $bar = new foo; $bar->do_foo(); ?> راجع فصل الأصناف والكائنات (Classes and Objects) للمزيد من المعلومات. التحويل إلى كائن إذا حوّلنا كائنًا إلى كائنٍ آخر فلن يُعدَّل فيه شيء، أما إذا حولنا قيمةً من أي نوعٍ آخر إلى كائن، فستُنشَأ نسخةً جديدةً من ...

(PHP 5 >= 5.3.0, PHP 7) يمكن استخدام عامل goto للانتقال إلى قسم آخر في البرنامج، وتعيّن نقطة الانتقال هذه بواسطة وسم متبوعٍ بنقطتين رأسيتين (:)، وتكون طريقة الانتقال باستخدام العامل goto متبوعًا بالوسم المراد الانتقال إليه. هناك بعض القيود المفروضة على استخدام goto، إذ يجب أن يكون الوسم الهدف في نفس الملف ونفس السياق (context)، بمعنى أنّه لا يمكن الانتقال من داخل الدالة أو التابع إلى الخارج كما لا يمكن الانتقال إلى الداخل. لا يمكن أيضًا الانتقال إلى أي ...

(PHP 4, PHP 5, PHP 7) تستخدم continue في الحلقات التكرارية لتجاوز ما يأتي بعدها في الحلقة التكرارية والاستمرار في تنفيذ الشيفرة حسب الشرط المعتمد في الحلقة ثم الانتقال إلى بداية الدورة التالية. تأخذ continue معاملًا عدديًّا اختياريًا يمكن من خلاله تحديد عدد الحلقات التكرارية المحيطة بها والتي يجب تجاوزها إلى النهاية. القيمة الافتراضية هي 1 والتي تعني الانتقال إلى نهاية الحلقة الحالية. ملاحظة: تعدّ عبارة switch في PHP من الحلقات التكرارية عند الحديث عن continue. تسلك continue سلوك break ...

(PHP 4, PHP 5, PHP 7) عبارة require_once مطابقة للعبارة require باستثناء أن PHP ستتحقق مما إذا كان الملف مضمّنًا أم لا، وذلك لتجنّب تضمينه (require) مرة أخرى. راجع توثيق include_once للمزيد من المعلومات حول طريقة عمل ‎_once، والفرق بينها وبين الدوال التي لا تلحق بها هذه اللاحقة. مصادر صفحة require_once في توثيق PHP الرسمي.

مقدمة لا مفرّ من الوقوع في الأخطاء مهما كنّا حريصين في كتابة الشيفرة. تبلغ PHP عن الأخطاء والتحذيرات والملاحظات التي تحدث بسبب المشاكل الحاصلة في وقت التشغيل، وتصبح عملية تنقيح الأخطاء (Debugging) أكثر سهولة عند معرفة كيفية الكشف عن هذه الأخطاء والتعامل معها. الأساسيات تبلّغ PHP عن الأخطاء الناجمة عن عدد من الأخطاء الداخلية، ويمكن الاستفادة من ذلك في الكشف عن عدد من الحالات المختلفة ويمكن عرضها و/أو تسجيلها حسب الحاجة. تقسم الأخطاء في PHP إلى أنواع مختلفة، وهناك قائمة ...

(PHP 4, PHP 5, PHP 7) العبارة require مطابقة للعبارة include باستثناء أنّها تطلق خطأ من نوع E_COMPLE_ERROR في حال فشلها في جلب الملف. وبعبارة أخرى فإنها ستوقف عمل الشيفرة تمامًا، في حين أنّ include تطلق تحذيرًا (E_WARNING) والذي لا يؤدي إلى إيقاف الشيفرة عن العمل. راجع توثيق include لمعرفة طريقة عملها. مصادر صفحة require في توثيق PHP الرسمي.

تقدّم المولِّدات (Generators) طريقة سهلة لاستخدام المكرِّرات (Iterators) البسيطة دون الدخول في تعقيدات استخدام صنف يطبّق الواجهة Iterator. تتيح المولِّدات كتابة شيفرة تستخدم foreach لمرور على مجموعة من البيانات دون الحاجة إلى بناء مصفوفة في الذاكرة مما قد يؤدي إلى تجاوز حدود الذاكرة، أو يحتاج إلى وقت معالجة طويل لإنشائه. بدلًا من ذلك، يمكن كتابة دالة مولِّدة وهي دالة مشابهة للدوال الاعتيادية باستثناء أنّها لا تعيد النتيجة مرة واحدة بل تعيد العدد المطلوب من النتائج لغرض تقديم القيم التي يتم ...

(PHP 4, PHP 5, PHP 7) قد ترغب في كثير من الأحيان تنفيذ عبارة معينة عند تحقق شرط معين وتنفيذ عبارة أخرى في حال عدم تحقق الشرط. هنا يأتي دور else، والتي تعمل على تمديد عبارة if لتنفيذ عبارة أخرى في حال أدّى حساب عبارة if إلى النتيجة FALSE. على سبيل المثال تطبع الشيفرة التالية عبارة 'a is greater than b' إن كان المتغير ‎$a أكبر من المتغير ‎$b، وتطبع العبارة 'a is NOT greater than b' إن كان ‎$a ...

(PHP 4, PHP 5, PHP 7) تقدّم بنية foreach طريقة سهلة للتنقل بين عناصر المصفوفات، وتعمل هذه البنية مع المصفوفات والكائنات فقط، ويؤدي استخدامها مع متغير ذي نوع بيانات مختلف أو متغير غير مهيئ إلى إطلاق خطأ. لهذه البنية صيغتان: foreach (array_expression as $value) statement foreach (array_expression as $key => $value) statement تنتقل الصيغة الأولى عبر المصفوفة بحسب التعبير المقدّم إليها (array_expression). وفي كل دورة تسند اللغة قيمة العنصر الحالي إلى المتغير ‎$value ويتقدّم المؤشر ...

تحتوي لغة PHP على عددٍ كبير من الدوال القياسية المُضمَّنة في اللغة. دوال المصفوفات الدوال الرياضية دوال معالجة النصوص

المراجع (references) في PHP هي وسيلة للوصول إلى محتوى المتغير نفسه باستخدام أسماء مختلفة، والمراجع لا تشبه المؤشّرات في لغة C، فعلى سبيل المثال لا يمكن إجراء العمليات الحسابية الخاصّة بالمؤشّرات على المراجع، وهي ليست عناوين ذاكرة حقيقية، وهكذا. راجع الصفحة "ما هو غير المقصود بالمراجع" للمزيد من المعلومات. المراجع هي أسماء بديلة رمزية مجدولة (Symbol table aliases). لاحظ أنّ اسم المتغير ومحتواه مختلفان في لغة PHP؛ لهذا يمكن لنفس المحتوى أن يحمل اسمين مختلفين. وأقرب مثال على ذلك هو ...

(PHP 4, PHP 5, PHP 7) تُضمِّن العبارة include_once الملفّ المحدد وتعالجه أثناء تنفيذ الشيفرة. هذه السلوك مشابه لعبارة include والفرق الوحيد هنا هو إن كانت شيفرة ذلك الملف مضمّنة من قبل فإنّها لن تُضمِّنَه مرة أخرى، وترجع include_once القيمة TRUE، وهذا السلوك متوقع من اسم العبارة. يمكن استخدام include_once في الحالات التي يمكن لنفس الملف أن يُضمَّن ويُعالَج لأكثر من مرة خلال مرحلة معيّنة من مراحل تنفيذ الشيفرة، وفي هذه الحالة يمكن تجنب بعض المشاكل مثل إعادة تعريف الدوال ...