عرض مصدر Python/TarFile/list

<noinclude>{{DISPLAYTITLE:التابع <code>TarFile.list()‎‎</code> في بايثون}}</noinclude>

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

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

<syntaxhighlight lang="python3">
TarFile.list(verbose=True, *, members=None)
</syntaxhighlight>

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

=== <code>members</code> ===
معامل اختياري، يجب أن يكون -في حال إعطائه قيمة معينة- مجموعة متفرعة subset من القائمة المعادة من التابع <code>[[Python/TarFile/getmembers|getmembers()]]</code>‎.

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

== القيمة المعادة ==
يطبع التابع جدولًا بمحتويات كائن <code>TarFile</code> إلى مخرجات النظام <code>sys.stdout</code>.

== أمثلة ==

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

<syntaxhighlight lang="python3">
>>> 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 

</syntaxhighlight>

== مصادر ==
[https://docs.python.org/3/library/tarfile.html#tarfile.TarFile.list صفحة Read and write tar archive files في توثيق بايثون الرسمي.]

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