الفرق بين المراجعتين ل"Python/TarFile/extractall"
(أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE:التابع <code>TarFile.extractall()</code> في بايثون}}</noinclude> يستخرج التابع جميع الأعضاء من م...') |
|||
سطر 2: | سطر 2: | ||
يستخرج التابع جميع الأعضاء من ملف الأرشيف إلى المجلد الحالي أو المسار المعطى. | يستخرج التابع جميع الأعضاء من ملف الأرشيف إلى المجلد الحالي أو المسار المعطى. | ||
− | + | ==البنية العامة== | |
− | == البنية العامة == | ||
− | |||
<syntaxhighlight lang="python3"> | <syntaxhighlight lang="python3"> | ||
TarFile.extractall(path=".", members=None, *, numeric_owner=False) | TarFile.extractall(path=".", members=None, *, numeric_owner=False) | ||
</syntaxhighlight> | </syntaxhighlight> | ||
− | + | ==المعاملات== | |
− | == المعاملات == | ||
− | |||
− | |||
− | |||
− | === | + | === <code>memebers</code> === |
− | + | معامل اختياري، ويجب أن يكون مجموعة متفرّعة subset من القائمة المعادة من التابع <code>[[Python/TarFile/getmembers|getmembers()]]</code>. يجري تحديد المعلومات الخاصة بالمجلد مثل صاحب المجلد ووقت التعديل والأذونات بعد استخراج جميع الأعضاء من ملف الأرشيف، ويحدث هذا لسببين: | |
+ | # يعاد تعيين قيمة وقت التعديل للمجلد في كل مرة يتم فيها إنشاء ملف جديد فيه. | ||
+ | # إن لم تسمح أذونات مجلّد معين بالكتابة فيه، ستفشل عملية استخراج الملفات إلى ذلك المجلد. | ||
− | + | === <code>numeric_owner</code> === | |
− | + | إن أخذ هذا المعامل القيمة <code>True</code> فإن الأعداد <code>uid</code> و <code>gid</code> من ملف tar ستستخدم لتعيين المالك أو المجموعة للملفات المستخرجة. أما إذا أخذ المعامل القيمة <code>False</code> تستخدم القيم المسماة من ملف tar. | |
− | ''' | + | '''تحذير''': |
− | |||
− | |||
− | + | لا تستخرج الملفات من ملفات أرشيف غير موثوقة المصدر دون التحري عنها مسبقًا. من المحتمل أن تكون الملفات قد أُنشئت خارج المسار <code>path</code>، كأن يمتلك الأعضاء مسارات ملفات مطلقة تبدأ بالرمز <code>"/"</code> أو <code>".."</code>. | |
+ | '''ملاحظات:''' | ||
+ | *أضيف المعامل <code>numeric_owner</code> في الإصدار 3.5 من بايثون. | ||
+ | *أصبح بالإمكان استخدام كائنات شبيهة بالمسارات path-like objects مع المعامل <code>path</code> في الإصدار 3.6 من بايثون. | ||
+ | ==القيمة المعادة== | ||
يعيد التابع القيمة <code>None</code> . | يعيد التابع القيمة <code>None</code> . | ||
− | + | ==أمثلة== | |
− | == أمثلة == | + | يبين المثال التالي آلية عمل التابع:<syntaxhighlight lang="python3"> |
− | |||
− | يبين المثال التالي آلية عمل التابع: | ||
− | |||
− | <syntaxhighlight lang="python3"> | ||
>>> import tarfile | >>> import tarfile | ||
>>> tar = tarfile.open('files.tar', 'r') | >>> tar = tarfile.open('files.tar', 'r') | ||
>>> tar.extractall() | >>> tar.extractall() | ||
</syntaxhighlight> | </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]] | ||
[[تصنيف:Python Modules]] | [[تصنيف:Python Modules]] | ||
[[تصنيف:Python Methods]] | [[تصنيف:Python Methods]] |
المراجعة الحالية بتاريخ 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()
: يستخرج التابع العضو المحدّد في المعاملات من ملف الأرشيف ككائن ملف.