التابع ZipFile.extractall() في بايثون
يستخرج التابع جميع الأعضاء في ملف الأرشيف إلى المجلد الحالي.
البنية العامة
ZipFile.extractall(path=None, members=None, pwd=None)
المعاملات
path
يحدّد المعامل مسارًا بديلًا لاستخراج الملفات فيه.
members
معامل اختياري يجب أن يكون مجموعة فرعية من القائمة المعادة بواسطة التابع namelist().
pwd
كلمة المرور المستخدمة لتعمية الملفات.
تحذير
لا تستخرج ملفات الأرشيف القادمة من مصادر غير موثوقة دون فحصها. من الممكن أن تكون الملفات قد أنشئت خارج المسار المحدد في المعامل path (مثل: ملفات تبدأ أسماءها بخط مائل "/" أو تتضمّن نقطتين ".."). تحاول هذه الوحدة تجنّب حدوث ذلك. راجع الملاحظات في التابع extract().
ملاحظات:
- يؤدي استدعاء التابع extractall() على كائن ZipFile مغلق إلى إطلاق الاستثناء ValueError في الإصدار 3.6 من بايثون. كان التابع يطلق الاستثناء RuntimeError في الإصدارات السابقة.
- أصبح المعامل path يستقبل كائنات شبيهة بالمسارات path-like objects في الإصدار 3.6.2 من بايثون.
القيمة المعادة
يعيد التابع القيمة None.
أمثلة
يبين المثال التالي طريقة استخراج الملفات إلى المجلد الحالي مرة، وإلى مجلد محدّد مرة أخرى:
import zipfile
zip = zipfile.ZipFile('files.zip')
zip.extractall() # استخراج الملفات إلى المجلد الحالي
zip.extractall('extractedfiles/') # استخراج الملفات إلى المجلّد المحدّد
انظر أيضًا
- التابع
ZipFile.extract(): يستخرج التابع الملف العضو المعطى من الأرشيف إلى المجلد الحالي.