الفرق بين المراجعتين لصفحة: «Python/TarFile/extractfile»
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE:التابع <code>TarFile.extractfile()</code> في بايثون}}</noinclude> يستخرج التابع العضو المحدّد في...' |
|||
| سطر 8: | سطر 8: | ||
TarFile.extractfile(member) | TarFile.extractfile(member) | ||
</syntaxhighlight> | </syntaxhighlight> | ||
== المعاملات == | == المعاملات == | ||
يمكن أن يكون المعامل اسم ملف filename أو كائن TarInfo. إن كانت قيمة هذا | === <code>member</code> === | ||
يمكن أن يكون المعامل اسم ملف <code>filename</code> أو كائن <code>[[Python/TarInfo|TarInfo]]</code>. إن كانت قيمة هذا المعامل ملفًا عاديًا أو وصلة فإنّ التابع سيعيد كائن <code>io.BufferedReader</code>، وإلا فإنّه سيعيد القيمة <code>None</code>. | |||
ملاحظة: أصبح التابع يعيد الكائن io.BufferedReader في الإصدار 3.3 من بايثون. | '''ملاحظة:''' أصبح التابع يعيد الكائن <code>io.BufferedReader</code> في الإصدار 3.3 من بايثون. | ||
== القيمة المعادة == | == القيمة المعادة == | ||
المراجعة الحالية بتاريخ 19:37، 14 نوفمبر 2018
يستخرج التابع العضو المحدّد في المعاملات من ملف الأرشيف ككائن ملف.
البنية العامة
TarFile.extractfile(member)
المعاملات
member
يمكن أن يكون المعامل اسم ملف filename أو كائن TarInfo. إن كانت قيمة هذا المعامل ملفًا عاديًا أو وصلة فإنّ التابع سيعيد كائن io.BufferedReader، وإلا فإنّه سيعيد القيمة None.
ملاحظة: أصبح التابع يعيد الكائن io.BufferedReader في الإصدار 3.3 من بايثون.
القيمة المعادة
يعيد التابع كائن ملف يمثّل الملفّ المُستخرج من أرشيف tar.
أمثلة
يبين المثال التالي آلية عمل التابع:
>>> import tarfile
>>> tar = tarfile.open('files.tar')
>>> tar.extractfile('file3.py')
<ExFileObject name='files.tar'>
انظر أيضًا
- التابع
TarFile.extractall(): يستخرج التابع جميع الأعضاء من ملف الأرشيف إلى المجلد الحالي أو المسار المعطى. - التابع
TarFile.extract(): يستخرج التابع عضوًا من ملف الأرشيف إلى المجلد الحالي مستخدمًا اسمه الكامل.
مصادر
صفحة Read and write tar archive files في توثيق بايثون الرسمي.