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

المراجعة الحالية بتاريخ 19:16، 14 نوفمبر 2018

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

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

TarFile.extractall(path=".", members=None, *, numeric_owner=False)

المعاملات

`‎memebers`

معامل اختياري، ويجب أن يكون مجموعة متفرّعة subset من القائمة المعادة من التابع getmembers()‎. يجري تحديد المعلومات الخاصة بالمجلد مثل صاحب المجلد ووقت التعديل والأذونات بعد استخراج جميع الأعضاء من ملف الأرشيف، ويحدث هذا لسببين:

يعاد تعيين قيمة وقت التعديل للمجلد في كل مرة يتم فيها إنشاء ملف جديد فيه.
إن لم تسمح أذونات مجلّد معين بالكتابة فيه، ستفشل عملية استخراج الملفات إلى ذلك المجلد.

`numeric_owner`

إن أخذ هذا المعامل القيمة True فإن الأعداد uid و gid من ملف tar ستستخدم لتعيين المالك أو المجموعة للملفات المستخرجة. أما إذا أخذ المعامل القيمة False تستخدم القيم المسماة من ملف tar.

تحذير:

لا تستخرج الملفات من ملفات أرشيف غير موثوقة المصدر دون التحري عنها مسبقًا. من المحتمل أن تكون الملفات قد أُنشئت خارج المسار path، كأن يمتلك الأعضاء مسارات ملفات مطلقة تبدأ بالرمز "/" أو "..".

ملاحظات:

أضيف المعامل numeric_owner في الإصدار 3.5 من بايثون.
أصبح بالإمكان استخدام كائنات شبيهة بالمسارات path-like objects مع المعامل path في الإصدار 3.6 من بايثون.

القيمة المعادة

يعيد التابع القيمة None .

أمثلة

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

>>> import tarfile
>>> tar = tarfile.open('files.tar', 'r')
>>> tar.extractall()

انظر أيضًا

التابع TarFile.extract()‎: يستخرج التابع عضوًا من ملف الأرشيف إلى المجلد الحالي مستخدمًا اسمه الكامل.
التابع TarFile.extractfile()‎: يستخرج التابع العضو المحدّد في المعاملات من ملف الأرشيف ككائن ملف.

مصادر

صفحة Read and write tar archive files في توثيق بايثون الرسمي.

@@ سطر 2: / سطر 2: @@
 يستخرج التابع جميع الأعضاء من ملف الأرشيف إلى المجلد الحالي أو المسار المعطى.
+==البنية العامة==
-== البنية العامة ==
 <syntaxhighlight lang="python3">
 TarFile.extractall(path=".", members=None, *, numeric_owner=False)
 </syntaxhighlight>
-‎
+==المعاملات==
-== المعاملات ==
-‎
-=== memebers ===
-معامل اختياري، ويجب أن يكون -في حال تحديد قيمة له- مجموعة متفرّعة subset من القائمة المعادة من التابع getmembers()‎. يجري تحديد المعلومات الخاصة بالمجلد مثل صاحب المجلد ووقت التعديل والأذونات بعد استخراج جميع الأعضاء من ملف الأرشيف، ويحدث هذا لسببين: أولاً: تعاد تعيين قيمة وقت التعديل للمجلد في كل مرة يتم فيها إنشاء ملف جديد فيه. ثانيًا: إن لم تسمح أذونات مجلّد معين بالكتابة فيه، ستفشل عملية استخراج الملفات إلى ذلك المجلد.
-=== numeric_owner ===
+=== <code>‎memebers</code> ===
-إن أخذ هذا المعامل القيمة True فإن الأعداد uid و gid من ملف tar ستستخدم لتعيين المالك أو المجموعة للملفات المستخرجة. أما إذا أخذ المعامل القيمة False تستخدم القيم المسماة من ملف tar.
+معامل اختياري، ويجب أن يكون مجموعة متفرّعة subset من القائمة المعادة من التابع <code>[[Python/TarFile/getmembers|getmembers()]]</code>‎. يجري تحديد المعلومات الخاصة بالمجلد مثل صاحب المجلد ووقت التعديل والأذونات بعد استخراج جميع الأعضاء من ملف الأرشيف، ويحدث هذا لسببين:
+# يعاد تعيين قيمة وقت التعديل للمجلد في كل مرة يتم فيها إنشاء ملف جديد فيه.
+# إن لم تسمح أذونات مجلّد معين بالكتابة فيه، ستفشل عملية استخراج الملفات إلى ذلك المجلد.
-'''تحذير'''
+=== <code>numeric_owner</code> ===
-لا تستخرج الملفات من ملفات أرشيف غير موثوقة المصدر دون التحري عنها مسبقًا. من المحتمل أن تكون الملفات قد أُنشئت خارج المسار path، كأن يمتلك الأعضاء مسارات ملفات مطلقة تبدأ بالرمز "/" أو "..".
+إن أخذ هذا المعامل القيمة <code>True</code> فإن الأعداد <code>uid</code> و <code>gid</code> من ملف tar ستستخدم لتعيين المالك أو المجموعة للملفات المستخرجة. أما إذا أخذ المعامل القيمة <code>False</code> تستخدم القيم المسماة من ملف tar.
-'''ملاحظات:'''
+'''تحذير''':
-* أضيف المعامل numeric_owner في الإصدار 3.5 من بايثون.
-* أصبح بالإمكان استخدام كائنات شبيهة بالمسارات path-like objects مع المعامل path في الإصدار 3.6 من بايثون.
-== القيمة المعادة ==
+لا تستخرج الملفات من ملفات أرشيف غير موثوقة المصدر دون التحري عنها مسبقًا. من المحتمل أن تكون الملفات قد أُنشئت خارج المسار <code>path</code>، كأن يمتلك الأعضاء مسارات ملفات مطلقة تبدأ بالرمز <code>"/"</code> أو <code>".."</code>.
+'''ملاحظات:'''
+*أضيف المعامل <code>numeric_owner</code> في الإصدار 3.5 من بايثون.
+*أصبح بالإمكان استخدام كائنات شبيهة بالمسارات path-like objects مع المعامل <code>path</code> في الإصدار 3.6 من بايثون.
+==القيمة المعادة==
 يعيد التابع القيمة <code>None</code> .
+==أمثلة==
-== أمثلة ==
+يبين المثال التالي آلية عمل التابع:<syntaxhighlight lang="python3">
-يبين المثال التالي آلية عمل التابع:
-<syntaxhighlight lang="python3">
 >>> import tarfile
 >>> tar = tarfile.open('files.tar', 'r')
 >>> tar.extractall()
 </syntaxhighlight>
+==انظر أيضًا==
-== انظر أيضًا ==
+*التابع <code>[[Python/TarFile/extract|TarFile.extract()‎]]</code>: يستخرج التابع عضوًا من ملف الأرشيف إلى المجلد الحالي مستخدمًا اسمه الكامل.
-* التابع <code>[[Python/TarFile/extract|TarFile.extract()‎]]</code>: يستخرج التابع عضوًا من ملف الأرشيف إلى المجلد الحالي مستخدمًا اسمه الكامل.
+*التابع <code>[[Python/TarFile/extractfile|TarFile.extractfile()‎]]</code>: يستخرج التابع العضو المحدّد في المعاملات من ملف الأرشيف ككائن ملف.
-* التابع <code>[[Python/TarFile/extractfile|TarFile.extractfile()‎]]</code>: يستخرج التابع العضو المحدّد في المعاملات من ملف الأرشيف ككائن ملف.
+==مصادر==
+* <span> </span>[https://docs.python.org/3/library/tarfile.html#tarfile.TarFile.extractall صفحة Read and write tar archive files في توثيق بايثون الرسمي.]
-== مصادر ==
-[https://docs.python.org/3/library/tarfile.html#tarfile.TarFile.extractall صفحة Read and write tar archive files في توثيق بايثون الرسمي.]
 [[تصنيف:Python]]
 [[تصنيف:Python Modules]]
 [[تصنيف:Python Methods]]