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

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

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

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

return S_ISREG(self.stat().st_mode)

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

is_file()

المعاملات

بدون معاملات

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

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

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

أمثلة

>>> p=Path('D:\\Users\\MOUSTAFA\\Desktop')

>>> p.is_dir()
True

>>> p.is_file()
False

>>> (p/'desktop.ini').is_file()
True

انظر أيضًا

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

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

مصادر

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

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