الفرق بين المراجعتين لصفحة: «Python/ZipFile/extractall»

مراجعة 07:52، 16 نوفمبر 2018

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

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

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()‎: يستخرج التابع الملف العضو المعطى من الأرشيف إلى المجلد الحالي.

مصادر

صفحة Work with ZIP archives في توثيق بايثون الرسمي.

@@ سطر 8: / سطر 8: @@
 ZipFile.extractall(path=None, members=None, pwd=None)
 </syntaxhighlight>
-‎
-== المعاملات ==
+== ‎المعاملات ==
-‎
+‎<code>path</code>
-=== path ===
 يحدّد المعامل مسارًا بديلًا لاستخراج الملفات فيه.
-=== members ===
+=== <code>members</code> ===
-معامل اختياري يجب أن يكون مجموعة فرعية من القائمة المعادة بواسطة التابع namelist()‎.
+معامل اختياري يجب أن يكون مجموعة فرعية من القائمة المعادة بواسطة التابع <code>[[Python/ZipFile/namelist|namelist()‎]]</code>.
-=== pwd ===
+=== <code>pwd</code> ===
 كلمة المرور المستخدمة لتعمية الملفات.
 '''تحذير'''
-لا تستخرج ملفات الأرشيف القادمة من مصادر غير موثوقة دون فحصها. من الممكن أن تكون الملفات قد أنشئت خارج المسار المحدد في المعامل path (مثل: ملفات تبدأ أسماءها بخط مائل "/" أو تتضمّن نقطتين ".."). تحاول هذه الوحدة تجنّب حدوث ذلك. راجع الملاحظات في التابع extract()‎.
+لا تستخرج ملفات الأرشيف القادمة من مصادر غير موثوقة دون فحصها. من الممكن أن تكون الملفات قد أنشئت خارج المسار المحدد في المعامل <code>path</code> (مثل: ملفات تبدأ أسماءها بخط مائل <code>"/"</code> أو تتضمّن نقطتين <code>".."</code>). تحاول هذه الوحدة تجنّب حدوث ذلك. راجع الملاحظات في التابع <code>[[Python/ZipFile/extract|extract()‎]]</code>.
 '''ملاحظات:'''
-* يؤدي استدعاء التابع extractall()‎ على كائن ZipFile مغلق إلى إطلاق الاستثناء ValueError في الإصدار 3.6 من بايثون. كان التابع يطلق الاستثناء RuntimeError في الإصدارات السابقة.
+* يؤدي استدعاء التابع <code>extractall()</code>‎ على كائن <code>[[Python/ZipFile|ZipFile]]</code> مغلق إلى إطلاق الاستثناء <code>ValueError</code> في الإصدار 3.6 من بايثون. كان التابع يطلق الاستثناء <code>RuntimeError</code> في الإصدارات السابقة.
-* أصبح المعامل path يستقبل كائنات شبيهة بالمسارات path-like objects في الإصدار 3.6.2 من بايثون.
+* أصبح المعامل <code>path</code> يستقبل كائنات شبيهة بالمسارات path-like objects في الإصدار 3.6.2 من بايثون.
 == القيمة المعادة ==
@@ سطر 47: / سطر 46: @@
 == مصادر ==
-[https://docs.python.org/3/library/zipfile.html#zipfile.ZipFile.extractall صفحة Work with ZIP archives في توثيق بايثون الرسمي.]
+* [https://docs.python.org/3/library/zipfile.html#zipfile.ZipFile.extractall صفحة Work with ZIP archives في توثيق بايثون الرسمي.]
 [[تصنيف:Python]]
 [[تصنيف:Python Modules]]
 [[تصنيف:Python Methods]]