الفرق بين المراجعتين لصفحة: «Python/TarFile/addfile»
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE:التابع <code>TarFile.addfile()</code> في بايثون}}</noinclude> يضيف التابع كائن TarInfo المعطى إلى...' |
لا ملخص تعديل |
||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE:التابع <code>TarFile.addfile()</code> في بايثون}}</noinclude> | <noinclude>{{DISPLAYTITLE:التابع <code>TarFile.addfile()</code> في بايثون}}</noinclude> | ||
يضيف التابع كائن TarInfo المعطى إلى ملف الأرشيف. | يضيف التابع كائن <code>TarInfo</code> المعطى إلى ملف الأرشيف. | ||
== البنية العامة == | == البنية العامة == | ||
<syntaxhighlight lang="python3"> | <syntaxhighlight lang="python3"> | ||
TarFile.addfile(tarinfo, fileobj=None) | |||
</syntaxhighlight> | |||
== المعاملات == | |||
== | === <code>fileobj</code> === | ||
=== fileobj === | |||
معامل اختياري يجب أن تكون قيمته ملفًّا ثنائيًا، وتُقرأ عدد البايتات في tarinfo.size من هذا الملف وتضاف إلى الأرشيف. | معامل اختياري يجب أن تكون قيمته ملفًّا ثنائيًا، وتُقرأ عدد البايتات في <code>tarinfo.size</code> من هذا الملف وتضاف إلى الأرشيف. | ||
يمكن إنشاء كائنات TarInfo مباشرة، أو باستخدام التابع gettarinfo(). | يمكن إنشاء كائنات <code>[[Python/TarInfo|TarInfo]]</code> مباشرة، أو باستخدام التابع <code>[[Python/TarFile/gettarinfo|gettarinfo()]]</code>. | ||
== القيمة المعادة == | == القيمة المعادة == | ||
المراجعة الحالية بتاريخ 19:57، 14 نوفمبر 2018
يضيف التابع كائن TarInfo المعطى إلى ملف الأرشيف.
البنية العامة
TarFile.addfile(tarinfo, fileobj=None)
المعاملات
fileobj
معامل اختياري يجب أن تكون قيمته ملفًّا ثنائيًا، وتُقرأ عدد البايتات في tarinfo.size من هذا الملف وتضاف إلى الأرشيف.
يمكن إنشاء كائنات TarInfo مباشرة، أو باستخدام التابع gettarinfo().
القيمة المعادة
يعيد التابع القيمة None.
أمثلة
يبين المثال التالي آلية عمل التابع:
>>> import tarfile
>>> tar = tarfile.open('files.tar', 'w')
>>> tar_info = tar.gettarinfo('file5.js')
>>> tar.addfile(tar_info)
انظر أيضًا
- التابع
TarFile.add(): يضيف التابع الملف المعطى إلى ملف الأرشيف. - التابع
TarFile.gettarinfo(): ينشئ التابع كائنTarInfoمن نتيجة استدعاء الدالةos.stat()أو ما يكافئها على ملف موجود فعلًا.
مصادر
صفحة Read and write tar archive files في توثيق بايثون الرسمي.