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