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

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

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

<syntaxhighlight lang="python3">
ZipFile.extract(member, path=None, pwd=None)

</syntaxhighlight>
== المعاملات ==

=== ‎<code>member</code> ===
اسم عضو الأرشيف الكامل أو كائن <code>[[Python/ZipInfo|ZipInfo]]</code>. يحاول التابع استخراج المعلومات بأكبر دقة ممكنة.

=== <code>path</code> ===
المجلد الذي ترغب في استخراج الملف إليه بدلًا من المجلد الحالي.

=== <code>pwd</code> ===
كلمة المرور المستخدمة في تعمية الملف المضغوط.
== القيمة المعادة ==
يعيد التابع المسار المسوّى (normalized path) الناشئ (مجلّد أو ملف جديد).

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

* إن امتلك اسم الملف لعضو معيّن في الأرشيف مسارًا مطلقًا، فسيُحذف منه اسم محرّك الأقراص أو نقطة مشاركة UNC إضافة إلى الخطوط المائلة، فيتحول المسار <code>‎///foo/bar</code> إلى <code>foo/bar</code> في نظام يونكس، ويتحول المسار <code>C:\foo\bar</code> إلى <code>foo\bar</code> في نظام ويندوز. كذلك تُحذف جميع النقاط <code>".."</code> من اسم الملف، فيتحول المسار <code>‎../../foo../../ba..r</code> إلى <code>foo../b..r</code>. كذلك تُستبدل المحارف التي لا يمكن استخدامها في تسمية الملفات (<code>:</code>، <code><</code>، <code>></code>، <code>|</code>، <code>"</code>، <code>?</code>، <code>*</code>) بالشرطة السفلية (<code>_</code>).
* يؤدي استدعاء التابع <code>extract()‎</code> على كائن <code>ZipFile</code> مغلق إلى إطلاق الاستثناء <code>ValueError</code> في الإصدار 3.6 من بايثون. كان التابع يطلق الاستثناء <code>RuntimeError</code> في الإصدارات السابقة.
* أصبح المعامل <code>path</code> يستقبل كائنات شبيهة بالمسارات path-like objects في الإصدار 3.6.2 من بايثون.
== أمثلة ==

يبين المثال التالي آلية عمل التابع:

<syntaxhighlight lang="python3">
>>> import zipfile
>>> zip = zipfile.ZipFile('files.zip')
>>> zip.extract('file2.html')
'/home/myfiles/file2.html'

</syntaxhighlight>

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

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

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