الفرق بين المراجعتين لصفحة: «Python/TarFile/add»
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE:التابع <code>TarFile.add()</code> في بايثون}}</noinclude> يضيف التابع الملف المعطى إلى ملف ال...' |
|||
| سطر 8: | سطر 8: | ||
TarFile.add(name, arcname=None, recursive=True, *, filter=None) | TarFile.add(name, arcname=None, recursive=True, *, filter=None) | ||
</syntaxhighlight> | </syntaxhighlight> | ||
== | == المعاملات == | ||
=== | === <code>name</code> === | ||
يمكن لهذا المعامل أن يكون أي نوع من الملفات (مجلد، fifo، وصلة رمزية، الخ). | يمكن لهذا المعامل أن يكون أي نوع من الملفات (مجلد، fifo، وصلة رمزية، الخ). | ||
=== arcname === | === <code>arcname</code> === | ||
يحدّد هذا المعامل اسمًا بديلًا للملف المضاف إلى الأرشيف. | يحدّد هذا المعامل اسمًا بديلًا للملف المضاف إلى الأرشيف. | ||
=== recursive === | === <code>recursive</code> === | ||
تضاف المجلّدات بصورة تعاودية recursively افتراضيًا، ويمكن تجنّب ذلك بتعيين القيمة False للمعامل recursive. يؤدي التعاود Recursion إلى إضافة المدخلات بالترتيب. | تضاف المجلّدات بصورة تعاودية recursively افتراضيًا، ويمكن تجنّب ذلك بتعيين القيمة False للمعامل recursive. يؤدي التعاود Recursion إلى إضافة المدخلات بالترتيب. | ||
| سطر 23: | سطر 23: | ||
'''ملاحظة:''' يؤدي التعاود Recursion إلى إضافة المدخلات بالترتيب في الإصدار 3.7 من بايثون. | '''ملاحظة:''' يؤدي التعاود Recursion إلى إضافة المدخلات بالترتيب في الإصدار 3.7 من بايثون. | ||
=== filter === | === <code>filter</code> === | ||
في حال تحديد قيمة لهذا المعامل فيجب أن تكون دالة تأخذ كائن TarInfo كوسيط وتعيد كائن TarInfo المعدّل. وإن أعادت الدالة القيمة None عوضًا عن ذلك، فإنّ كائن TarInfo سيُستبعد من الأرشيف. | في حال تحديد قيمة لهذا المعامل فيجب أن تكون دالة تأخذ كائن <code>[[Python/TarInfo|TarInfo]]</code> كوسيط وتعيد كائن <code>[[Python/TarInfo|TarInfo]]</code> المعدّل. وإن أعادت الدالة القيمة <code>None</code> عوضًا عن ذلك، فإنّ كائن [[Python/TarInfo|TarInfo]] سيُستبعد من الأرشيف. | ||
'''ملاحظة:''' أضيف المعامل filter في ا لإصدار 3.2 من بايثون. | '''ملاحظة:''' أضيف المعامل <code>filter</code> في ا لإصدار 3.2 من بايثون. | ||
== القيمة المعادة == | == القيمة المعادة == | ||
المراجعة الحالية بتاريخ 19:46، 14 نوفمبر 2018
يضيف التابع الملف المعطى إلى ملف الأرشيف.
البنية العامة
TarFile.add(name, arcname=None, recursive=True, *, filter=None)
المعاملات
name
يمكن لهذا المعامل أن يكون أي نوع من الملفات (مجلد، fifo، وصلة رمزية، الخ).
arcname
يحدّد هذا المعامل اسمًا بديلًا للملف المضاف إلى الأرشيف.
recursive
تضاف المجلّدات بصورة تعاودية recursively افتراضيًا، ويمكن تجنّب ذلك بتعيين القيمة False للمعامل recursive. يؤدي التعاود Recursion إلى إضافة المدخلات بالترتيب.
ملاحظة: يؤدي التعاود Recursion إلى إضافة المدخلات بالترتيب في الإصدار 3.7 من بايثون.
filter
في حال تحديد قيمة لهذا المعامل فيجب أن تكون دالة تأخذ كائن TarInfo كوسيط وتعيد كائن TarInfo المعدّل. وإن أعادت الدالة القيمة None عوضًا عن ذلك، فإنّ كائن TarInfo سيُستبعد من الأرشيف.
ملاحظة: أضيف المعامل filter في ا لإصدار 3.2 من بايثون.
القيمة المعادة
يعيد التابع القيمة None.
أمثلة
يبين المثال التالي آلية عمل التابع:
>>> import tarfile
>>> tar = tarfile.open('files.tar', 'w')
>>> tar.add('file4.css')
انظر أيضًا
- التابع
TarFile.addfile(): يضيف التابع كائنTarInfoالمعطى إلى ملف الأرشيف.
مصادر
صفحة Read and write tar archive files في توثيق بايثون الرسمي.