الفرق بين المراجعتين ل"Python/pathlib/Path/exists"

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

المراجعة الحالية بتاريخ 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 في توثيق بايثون الرسمي.