التابع TarFile.list()‎‎ في بايثون

يطبع التابع جدولًا بمحتويات كائن 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 في توثيق بايثون الرسمي.