عرض مصدر Python/ZipFile/write

<noinclude>{{DISPLAYTITLE:التابع <code>ZipFile.write()‎‎</code> في بايثون}}</noinclude>
يضيف التابع الملف المعطى إلى ملف الأرشيف.

== البنية العامة ==

<syntaxhighlight lang="python3">
ZipFile.write(filename, arcname=None, compress_type=None, compresslevel=None)
</syntaxhighlight>
‎
== المعاملات ==
‎
=== filename ===

اسم الملف المراد إضافته إلى الأرشيف.

=== arcname ===
الاسم الذي يعطيه التابع للملف المضاف إلى الأرشيف.

القيمة الافتراضية لهذا المعامل هي نفس قيمة المعامل filename ولكن مع حذف اسم محرّك الأقراص والفواصل الموجودة في بداية المسار

=== compress_type ===
معامل اختياري تعيد قيمته تعريف القيمة المحدّدة للمعامل compression في الدالة البانية لكائنات ZipFile.

=== compresslevel ===
معامل اختياري تعيد قيمته تعريف القيمة المقابلة لها في الدالة البانية.

'''ملاحظات:'''
* يجب فتح الأرشيف بوضع 'w' أو 'x' أو 'a'.
* لا تدعم ملّفات ZIP ترميزًا معيًنا؛ لذا إن كانت ملفّاتك مرمّزة بالترميز الموحد unicode يجب عليك تحويل أسماء الملفات إلى سلاسل بايتات نصية بالترميز المطلوب قبل تمرير الملفات إلى التابع write()‎. يفسّر برنامج WinZip أسماء الملفات كلّها على أنّها مرمّزة بالترميز CP437 والمعروف أيضًا بالترميز DOS Latin.
* يجب أن تكن أسماء الملفات في الأرشيف نسبية إلى جذر الأرشيف، بمعنى أنّه يجب أن لا تبدأ أسماء الملفات بفاصل المسار.
* إن احتوت قيمة المعامل arcname (أو المعامل filename إن كان arcname غير متوفّر) على بايتات من نوع null، فسيجري اقتطاع اسم الملف في الأرشيف عند البايت من نوع null.
* يؤدي استدعاء التابع testzip()‎ على كائن ZipFile مغلق إلى إطلاق الاستثناء ValueError في الإصدار 3.6 من بايثون. كان التابع يطلق الاستثناء RuntimeError في الإصدارات السابقة.

== القيمة المعادة ==
يعيد التابع القمية <code>None</code>.
== أمثلة ==

يبين المثال التالي طريقة إضافة ملف إلى الأرشيف:

<syntaxhighlight lang="python3">
>>> import zipfile
>>> zip = zipfile.ZipFile('files.zip')
>>> zip.printdir()
File Name                                             Modified             Size
file1.txt                                      2018-11-16 10:33:06           12
file2.html                                     2018-11-16 10:41:28            0
file3.py                                       2018-11-14 21:24:14            0
>>> zip.close()
>>> zip = zipfile.ZipFile('files.zip', 'a')
>>> zip.write('file4.css')
>>> zip.printdir()
File Name                                             Modified             Size
file1.txt                                      2018-11-16 10:33:06           12
file2.html                                     2018-11-16 10:41:28            0
file3.py                                       2018-11-14 21:24:14            0
file4.css                                      2018-11-14 22:41:49            0

</syntaxhighlight>

== انظر أيضًا ==
* التابع <code>[[Python/ZipFile/writestr|ZipFile.writestr()‎]]</code>: يكتب التابع البيانات النصية المعطاة في الأرشيف.

== مصادر ==
[https://docs.python.org/3/library/zipfile.html#zipfile.ZipFile.write صفحة Work with ZIP archives في توثيق بايثون الرسمي.]

[[تصنيف:Python]]
[[تصنيف:Python Modules]]
[[تصنيف:Python Methods]]