الدالة ()os.fspath في بايثون
تُعيد الدالة تمثيل نظام الملفات من المسار المُمرَّر.
البنية العامة
fspath(path)
| الإصدار | التغييرات |
|---|---|
| 3.6 | أُضيفت الدالة في هذا الإصدار. |
المعاملات
path
المسار المُراد الحصول على تمثيله بنظام الملفات.
القيمة المعادة
ستُعيد الدالة قيمة غير مُغيَّرة من الأصل إن مُرِّرَ لها سلسلة نصيّة أو سلسلة بايتات تُمثِّل تمثيل المسار المُمرَّر بنظام الملفات. سيُستدعى التابِع ()__fspath__ إن مُرِّرَ للدالة مُعطىً من نوع آخر، وسيُعيد التابِع قيمته فقط إن كان كائِنه سلسلةً نصيّة أو سلسلة بايتات. ستُصدِر الدالة الاستثناء TypeError إن مُرِّرَ لها نوع آخر لها ليس من بين الأنواع السالِف ذكرها.
أمثلة
يُبيّن المثال التالي آلية عمل الدالة.
>>> from os import fspath
>>> fspath('/home')
'/home'
>>> fspath(b'/home')
b'/home'
>>> fspath(1)
Traceback (most recent call last):
File "<stdin>", line 1, in <module>
TypeError: expected str, bytes or os.PathLike object, not int