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

المراجعة الحالية بتاريخ 00:10، 26 أغسطس 2018

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

يدلّ على كون المسار مشيرًا إلى ملف أو مجلد حقيقي أم لا.

ملاحظة: إذا كان المسار يشير إلى اختصار (symlink) فإن ناتج استدعاء التابع exists مرتبط بما يشير إليه الاختصار.

وتعتمد آلية التحقق على محاولة استدعاء التابع stat للكائن، وفي حال رمي استثناء من نوع OSError فإن التابع exists يعيد False.

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

exists()

المعاملات

بدون معاملات

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

يعيد True إن كان الملف موجودًا ضمن نظام الملفات، ويعيد False في حال عدم وجوده.

أمثلة

يبين المثال التالي طريقة استخدام التابع:

>>> Path('.').exists()
True

>>> Path('setup.py').exists()
True

>>> Path('/etc').exists()
True

>>> Path('nonexistentfile').exists()
False

انظر أيضًا

التابع os.path.exists المكافئ.

مصادر

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

@@ سطر 1: / سطر 1: @@
-== التابع Path.cwd ==
+==التابع <code>Path.exists</code> في بايثون==
-يعيد كائن مسار جديدًا يمثّل المسار الحالي (بشكل مشابه للتابع os.getcwd)<syntaxhighlight lang="python3">
+يدلّ على كون المسار مشيرًا إلى ملف أو مجلد حقيقي أم لا.
->>> Path.cwd()
-PosixPath('/home/antoine/pathlib')
+ملاحظة: إذا كان المسار يشير إلى اختصار ([[wikipedia:Symbolic_link|symlink]]) فإن ناتج استدعاء التابع <code>exists</code> مرتبط بما يشير إليه الاختصار.
+وتعتمد آلية التحقق على محاولة استدعاء التابع <code>stat</code> للكائن، وفي حال رمي استثناء من نوع <code>OSError</code> فإن التابع <code>exists</code> يعيد <code>False</code>.
+==البنية العامة==
+<syntaxhighlight lang="python3">
+exists()
+</syntaxhighlight>
+==المعاملات==
+بدون معاملات
+==القيمة المعادة==
+يعيد <code>True</code> إن كان الملف موجودًا ضمن نظام الملفات، ويعيد <code>False</code> في حال عدم وجوده.
+==أمثلة==
+يبين المثال التالي طريقة استخدام التابع:<syntaxhighlight lang="python3">
+>>> Path('.').exists()
+True
-</syntaxhighlight><span> </span>
+>>> Path('setup.py').exists()
+True
+>>> Path('/etc').exists()
+True
+>>> Path('nonexistentfile').exists()
+False
+</syntaxhighlight>
+==انظر أيضًا==
+التابع <code>[[os/path/exists|os.path.exists]]</code> المكافئ.
+==مصادر==
+[https://docs.python.org/3/library/pathlib.html قسم الوحدة pathlib في توثيق بايثون الرسمي.]