الفرق بين المراجعتين لصفحة: «Python/TarFile/getmember»
لا ملخص تعديل |
|||
| سطر 16: | سطر 16: | ||
يعيد التابع كائن <code>[[Python/TarInfo|TarInfo]]</code> لعضو ملف الأرشيف المعطى، إن لم يتمكن التابع من العثور على الاسم المعطى في ملف الأرشيف، فإنّه يُطلق الاستثناء <code>KeyError</code>. | يعيد التابع كائن <code>[[Python/TarInfo|TarInfo]]</code> لعضو ملف الأرشيف المعطى، إن لم يتمكن التابع من العثور على الاسم المعطى في ملف الأرشيف، فإنّه يُطلق الاستثناء <code>KeyError</code>. | ||
'''ملاحظة:''' في حال تكرار عضو من أعضاء الأرشيف لأكثر من مرة، فإنّ الظهور الأخير لهذا العضو سيُعدّ النسخة الأحدث منه. | |||
== أمثلة == | == أمثلة == | ||
المراجعة الحالية بتاريخ 18:34، 14 نوفمبر 2018
يعيد التابع كائن TarInfo لعضو ملف الأرشيف المعطى.
البنية العامة
TarFile.getmember(name)
المعاملات
name
اسم العضو في ملف الأرشيف.
القيمة المعادة
يعيد التابع كائن TarInfo لعضو ملف الأرشيف المعطى، إن لم يتمكن التابع من العثور على الاسم المعطى في ملف الأرشيف، فإنّه يُطلق الاستثناء KeyError.
ملاحظة: في حال تكرار عضو من أعضاء الأرشيف لأكثر من مرة، فإنّ الظهور الأخير لهذا العضو سيُعدّ النسخة الأحدث منه.
أمثلة
يبين المثال التالي آلية عمل التابع:
>>> import tarfile
>>> tar = tarfile.open(files.tar)
>>> tar = tarfile.open('files.tar')
>>> tar.getmember('file2.html')
<TarInfo 'file2.html' at 0x7f486610b110>
انظر أيضًا
- التابع
TarFile.getmembers(): يعيد التابع أعضاء الأرشيف على هيئة قائمة من كائناتTarInfo.
- التابع
TarFile.getnames(): يعيد التابع قائمة بأسماء الأعضاء في الأرشيف.
مصادر
صفحة Read and write tar archive files في توثيق بايثون الرسمي.