الفرق بين المراجعتين لصفحة: «Python/TarFile/getmember»
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE:التابع <code>TarFile.getmember()</code> في بايثون}}</noinclude> يعيد التابع كائن TarInfo لعضو ملف ا...' |
لا ملخص تعديل |
||
| (2 مراجعات متوسطة بواسطة نفس المستخدم غير معروضة) | |||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE:التابع <code>TarFile.getmember()</code> في بايثون}}</noinclude> | <noinclude>{{DISPLAYTITLE:التابع <code>TarFile.getmember()</code> في بايثون}}</noinclude> | ||
يعيد التابع كائن TarInfo لعضو ملف الأرشيف المعطى. | يعيد التابع كائن <code>[[Python/TarInfo|TarInfo]]</code> لعضو ملف الأرشيف المعطى. | ||
== البنية العامة == | == البنية العامة == | ||
| سطر 8: | سطر 8: | ||
TarFile.getmember(name) | TarFile.getmember(name) | ||
</syntaxhighlight> | </syntaxhighlight> | ||
== المعاملات == | == المعاملات == | ||
=== <code>name</code> === | === <code>name</code> === | ||
| سطر 16: | سطر 15: | ||
== القيمة المعادة == | == القيمة المعادة == | ||
يعيد التابع كائن TarInfo لعضو ملف الأرشيف المعطى، إن لم يتمكن التابع من العثور على الاسم المعطى في ملف الأرشيف، فإنّه يُطلق الاستثناء KeyError. | يعيد التابع كائن <code>[[Python/TarInfo|TarInfo]]</code> لعضو ملف الأرشيف المعطى، إن لم يتمكن التابع من العثور على الاسم المعطى في ملف الأرشيف، فإنّه يُطلق الاستثناء <code>KeyError</code>. | ||
'''ملاحظة:''' في حال تكرار عضو من أعضاء الأرشيف لأكثر من مرة، فإنّ الظهور الأخير لهذا العضو سيُعدّ النسخة الأحدث منه. | |||
== أمثلة == | == أمثلة == | ||
| سطر 32: | سطر 33: | ||
== انظر أيضًا == | == انظر أيضًا == | ||
* التابع [Python/TarFile/getmembers|TarFile.getmembers()]: يعيد التابع أعضاء الأرشيف على هيئة قائمة من كائنات <code>[[Python/TarInfo|TarInfo]]</code> | *التابع <code>[[Python/TarFile/getmembers|TarFile.getmembers()]]</code>: يعيد التابع أعضاء الأرشيف على هيئة قائمة من كائنات <code>[[Python/TarInfo|TarInfo]]</code>. | ||
*التابع <code>[[Python/TarFile/getnames|TarFile.getnames()]]</code>: يعيد التابع قائمة بأسماء الأعضاء في الأرشيف. | |||
== مصادر == | == مصادر == | ||
[https://docs.python.org/3/library/tarfile.html#tarfile.TarFile.getmember صفحة Read and write tar archive files في توثيق بايثون الرسمي.] | [https://docs.python.org/3/library/tarfile.html#tarfile.TarFile.getmember صفحة Read and write tar archive files في توثيق بايثون الرسمي.] | ||
المراجعة الحالية بتاريخ 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 في توثيق بايثون الرسمي.