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

<noinclude>{{DISPLAYTITLE:التابع <code>ZipFile.extractall()‎‎</code> في بايثون}}</noinclude>

يستخرج التابع جميع الأعضاء في ملف الأرشيف إلى المجلد الحالي.

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

<syntaxhighlight lang="python3">
ZipFile.extractall(path=None, members=None, pwd=None)
</syntaxhighlight>
‎
== المعاملات ==
‎
=== path ===
يحدّد المعامل مسارًا بديلًا لاستخراج الملفات فيه.

=== members ===
معامل اختياري يجب أن يكون مجموعة فرعية من القائمة المعادة بواسطة التابع namelist()‎.

=== pwd ===
كلمة المرور المستخدمة لتعمية الملفات.

'''تحذير'''

لا تستخرج ملفات الأرشيف القادمة من مصادر غير موثوقة دون فحصها. من الممكن أن تكون الملفات قد أنشئت خارج المسار المحدد في المعامل path (مثل: ملفات تبدأ أسماءها بخط مائل "/" أو تتضمّن نقطتين ".."). تحاول هذه الوحدة تجنّب حدوث ذلك. راجع الملاحظات في التابع extract()‎.

'''ملاحظات:'''

* يؤدي استدعاء التابع extractall()‎ على كائن ZipFile مغلق إلى إطلاق الاستثناء ValueError في الإصدار 3.6 من بايثون. كان التابع يطلق الاستثناء RuntimeError في الإصدارات السابقة.
* أصبح المعامل path يستقبل كائنات شبيهة بالمسارات path-like objects في الإصدار 3.6.2 من بايثون.

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

يبين المثال التالي طريقة استخراج الملفات إلى المجلد الحالي مرة، وإلى مجلد محدّد مرة أخرى:

<syntaxhighlight lang="python3">
import zipfile
zip = zipfile.ZipFile('files.zip')
zip.extractall()    # استخراج الملفات إلى المجلد الحالي
zip.extractall('extractedfiles/')      # استخراج الملفات إلى المجلّد المحدّد

</syntaxhighlight>

== انظر أيضًا ==
* التابع <code>[[Python/ZipFile/extract|ZipFile.extract()‎]]</code>: يستخرج التابع الملف العضو المعطى من الأرشيف إلى المجلد الحالي.

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

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