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

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

يطبع التابع جدولًا بمحتويات كائن TarFile إلى مخرجات النظام sys.stdout.

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

TarFile.list(verbose=True, *, members=None)

‎المعاملات

‎verbose إن أخذ المعامل verbose القيمة False، فسيطبع التابع أسماء أعضاء الأرشيف فقط. أما إن أخذ القيمة True (وهي القيمة الافتراضية)، فستكون المخرجات الناتجة مشابهة للمخرجات الناتجة من الأمر ls -l في الصدفة.

`members`

معامل اختياري، يجب أن يكون -في حال إعطائه قيمة معينة- مجموعة متفرعة subset من القائمة المعادة من التابع getmembers()‎.

ملاحظة: أضيف المعامل members في الإصدار 3.5 من بايثون.

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

يطبع التابع جدولًا بمحتويات كائن TarFile إلى مخرجات النظام sys.stdout.

أمثلة

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

>>> import tarfile
>>> tar = tarfile.open('files.tar')
>>> tar.list()
?rw-r--r-- mohammed/mohammed      10240 2018-11-14 21:24:27 file1.txt 
?rw-r--r-- mohammed/mohammed          0 2018-11-14 21:24:07 file2.html 
?rw-r--r-- mohammed/mohammed          0 2018-11-14 21:24:14 file3.py 
>>> tar.list(False)
file1.txt 
file2.html 
file3.py

مصادر

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

@@ سطر 8: / سطر 8: @@
 TarFile.list(verbose=True, *, members=None)
 </syntaxhighlight>
-‎
-== المعاملات ==
-‎
-=== verbose ===
-إن أخذ المعامل verbose القيمة False، فسيطبع التابع أسماء أعضاء الأرشيف فقط. أما إن أخذ القيمة True (وهي القيمة الافتراضية)، فستكون المخرجات الناتجة مشابهة للمخرجات الناتجة من الأمر ls -l في الصدفة.
-=== members ===
+== ‎المعاملات ==
-معامل اختياري، يجب أن يكون -في حال إعطائه قيمة معينة- مجموعة متفرعة subset من القائمة المعادة من التابع getmembers()‎.
+‎<code>verbose</code>
+إن أخذ المعامل <code>verbose</code> القيمة <code>False</code>، فسيطبع التابع أسماء أعضاء الأرشيف فقط. أما إن أخذ القيمة <code>True</code> (وهي القيمة الافتراضية)، فستكون المخرجات الناتجة مشابهة للمخرجات الناتجة من الأمر <code>ls -l</code> في [[Bash|الصدفة]].
-ملاحظة: أضيف المعامل members في الإصدار 3.5 من بايثون.
+=== <code>members</code> ===
+معامل اختياري، يجب أن يكون -في حال إعطائه قيمة معينة- مجموعة متفرعة subset من القائمة المعادة من التابع <code>[[Python/TarFile/getmembers|getmembers()]]</code>‎.
+'''ملاحظة:''' أضيف المعامل <code>members</code> في الإصدار 3.5 من بايثون.
 == القيمة المعادة ==