التابع ZipFile.writestr() في بايثون
يكتب التابع البيانات النصية المعطاة في الأرشيف.
البنية العامة
ZipFile.writestr(zinfo_or_arcname, data, compress_type=None, compresslevel=None)
المعاملات
zinfo_or_arcname
يأخذ هذا المعامل إحدى قيمتين، فإمّا أن يكون اسم الملف في الأرشيف، أو نسخة من الصنف ZipInfo. في حال كانت القيمة المعطاة هي نسخة من الصنف فيجب على الأقل تعيين قيمة للمعاملات filename و date و time على الأقل. أما إن كانت القيمة المعطاة هي اسم الملف، فسيعتمد التابع الوقت والتاريخ الحاليين.
يجب أن يكون الأرشيف مفتوحًا في الوضع 'w' أو 'x' أو 'a'.
compress_type
معامل اختياري - في حال تعريفه - تعيد قيمته تعريف القيمة المحدّدة للمعامل compression في الدالة البانية لكائنات ZipFile أو القيمة المحدّدة للمعامل zinfo_or_arcname (في حال استخدام نسخة من الصنف ZipInfo).
كذلك الأمر بالنسبة للمعامل compresslevel إذ تعيد قيمته تعريف القيمة المقابلة لها في الدالة البانية.
ملاحظة
إن استخدمت نسخة من الصنف ZipInfo كقيمة للمعامل zinfo_or_acrname فإنّ طريقة الضغط المستخدمة ستكون تلك المحدّدة في المعامل compress_type للعضو التابع إلى نسخة الصنف ZipInfo المعطاة. تعيّن الدالة البانية للصنف ZipInfo القيمة ZIP_STORED كقيمة افتراضية.
ملاحظات
- أضيف المعامل compress_type في الإصدار 3.2 من بايثون.
- يؤدي استدعاء التابع writestr() على كائن ZipFile مغلق أو أنشئ في الوضع 'r' إلى إطلاق الاستثناء ValueError في الإصدار 3.6 من بايثون. كان التابع يطلق الاستثناء RuntimeError في الإصدارات السابقة.
القيمة المعادة
يعيد التابع القيمة None.
أمثلة
يبين المثال التالي آلية عمل التابع: