الفرق بين المراجعتين ل"Python/ZipFile/extractall"
اذهب إلى التنقل
اذهب إلى البحث
(أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE:التابع <code>ZipFile.extractall()</code> في بايثون}}</noinclude> يستخرج التابع جميع الأعضاء في م...') |
|||
| سطر 8: | سطر 8: | ||
ZipFile.extractall(path=None, members=None, pwd=None) | ZipFile.extractall(path=None, members=None, pwd=None) | ||
</syntaxhighlight> | </syntaxhighlight> | ||
| − | + | ||
| − | == | + | == المعاملات == |
| − | | + | <code>path</code> |
| − | |||
يحدّد المعامل مسارًا بديلًا لاستخراج الملفات فيه. | يحدّد المعامل مسارًا بديلًا لاستخراج الملفات فيه. | ||
| − | === 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]] | ||
[[تصنيف:Python Modules]] | [[تصنيف:Python Modules]] | ||
[[تصنيف:Python Methods]] | [[تصنيف:Python Methods]] | ||
مراجعة 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(): يستخرج التابع الملف العضو المعطى من الأرشيف إلى المجلد الحالي.