الفرق بين المراجعتين لصفحة: «Python/pathlib/Path/is dir»

المراجعة الحالية بتاريخ 22:22، 15 سبتمبر 2018

التابع `Path.is_dir` في بايثون

يحدد هذا التابع فيما إذا كان المسار يشير إلى مجلد أو إلى غيره، وذلك باستخدامه للتابع stat ثم تمرير العنصر st_mode إلى التابع S_ISDIR من الوحدة stat، ويمكن رؤية ذلك ضمن الشيفرة المصدرية للمكتبة في السطر التالي

return S_ISDIR(self.stat().st_mode)

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

is_dir()

المعاملات

بدون معاملات

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

يعيد هذا التابع القيمة المنطقية True إذا كان المسار يشير إلى مجلد (أو إلى اختصار يشير إلى مجلد)، بينما يعيد False في حال كان المسار يشير إلى أي نوع آخر من الملفات.

كما أنه يعيد False إذا كان المسار غير موجود أو أن الاختصار بشير إلى مسار غير موجود، كما يمكن لأخطاء أخرى (مثل عدم وجود صلاحيات) أن تظهر.

أمثلة

>>> from pathlib import Path

>>> p=Path("D:\\Games")

>>> p.is_dir()
True

>>> p=p/ "1\\About Us.jpg"#عملية القسمة قد أُعيد تعريفها للتنقل بين المجلدات

>>> p
WindowsPath('D:/Games/1/About Us.jpg')

>>> p.is_dir()
False

انظر أيضًا

التابع stat ضمن توابع الصنف Path

التابع S_ISDIR ضمن توابع الوحدة stat.

مصادر

قسم الوحدة pathlib في توثيق بايثون الرسمي.

@@ سطر 1: / سطر 1: @@
-== التابع Path.cwd ==
+==التابع <code>Path.is_dir</code> في بايثون==
-يعيد كائن مسار جديدًا يمثّل المسار الحالي (بشكل مشابه للتابع os.getcwd)<syntaxhighlight lang="python3">
+يحدد هذا التابع فيما إذا كان المسار يشير إلى مجلد أو إلى غيره، وذلك باستخدامه للتابع [[Python/pathlib/Path/stat|stat]] ثم تمرير العنصر <code>st_mode</code> إلى التابع [[Python/stat/S ISDIR|S_ISDIR]] من الوحدة [[Python/stat|stat]]، ويمكن رؤية ذلك ضمن [https://github.com/python/cpython/blob/3.7/Lib/pathlib.py الشيفرة المصدرية للمكتبة]  في السطر التالي<syntaxhighlight lang="python3">
->>> Path.cwd()
+return S_ISDIR(self.stat().st_mode)
+</syntaxhighlight>
-PosixPath('/home/antoine/pathlib')
+==البنية العامة==
+<syntaxhighlight lang="python3">
+is_dir()
+</syntaxhighlight>
+==المعاملات==
+بدون معاملات
+==القيمة المعادة==
+يعيد هذا التابع القيمة المنطقية <code>True</code> إذا كان المسار يشير إلى مجلد (أو إلى اختصار يشير إلى مجلد)، بينما يعيد <code>False</code> في حال كان المسار يشير إلى أي نوع آخر من الملفات.
-</syntaxhighlight><span> </span>
+كما أنه يعيد <code>False</code> إذا كان المسار غير موجود أو أن الاختصار بشير إلى مسار غير موجود، كما يمكن لأخطاء أخرى (مثل عدم وجود صلاحيات) أن تظهر.
+==أمثلة==
+<syntaxhighlight lang="python3">
+>>> from pathlib import Path
+>>> p=Path("D:\\Games")
+>>> p.is_dir()
+True
+>>> p=p/ "1\\About Us.jpg"#عملية القسمة قد أُعيد تعريفها للتنقل بين المجلدات
+>>> p
+WindowsPath('D:/Games/1/About Us.jpg')
+>>> p.is_dir()
+False
+</syntaxhighlight>
+==انظر أيضًا==
+التابع [[Python/pathlib/Path/stat|<span>stat</span>]] ضمن توابع الصنف [[Python/pathlib/Path|Path]]
+التابع [[Python/stat/S ISDIR|<span>S_ISDIR</span>]] ضمن توابع الوحدة [[Python/stat|stat]].
+==مصادر==
+[https://docs.python.org/3/library/pathlib.html قسم الوحدة pathlib في توثيق بايثون الرسمي.]