التابع TarFile.getmember()‎‎ في بايثون

يعيد التابع كائن 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 في توثيق بايثون الرسمي.