عرض مصدر Python/ZipFile/read

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

يعيد التابع البايتات التابعة للملف المعطى في الأرشيف. 

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

<syntaxhighlight lang="python3">
ZipFile.read(name, pwd=None)
</syntaxhighlight>
‎
== المعاملات ==
‎name
اسم الملف في الأرشيف، أو كائن ZipInfo. يجب أن يكون الأرشيف مفتوحًا للقراءة أو للإلحاق. 

pwd
كلمة المرور المستخدمة للملفات المعماة، وإن جرى تعيين قيمة لهذا المعامل فإنّها ستعيد تعريف override كلمة المرور الافتراضية المعيّنة بواسطة التابع setpassword()‎. 

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

يعيد التابع البايتات التابعة للملف المعطى في الأرشيف. 

يؤدي استدعاء التابع read()‎ على كائن ZipFile يستخدم طريقة ضغط غير الطريقة ZIP_STORED أو ZIP_DEFLATED أو ZIP_BZIP2 أو ZIP_LZMA إلى إطلاق الاستثناء NotImplementedError. كذلك تُطلق اللغة خطأ إن كانت الوحدة المقابلة لطريقة الضغط غير متاحة.

'''ملاحظة:''' 

يؤدي استدعاء التابع read()‎ على كائن ZipFile مغلق إلى إطلاق الاستثناء ValueError في الإصدار 3.6 من بايثون. كان التابع يطلق الاستثناء RuntimeError في الإصدارات السابقة.

== أمثلة ==

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

<syntaxhighlight lang="python3">
>>> import zipfile
>>> zip = zipfile.ZipFile('files.zip')
>>> zip.read('file1.txt')
b'Hsoub Wiki.\n'

</syntaxhighlight>

== انظر أيضًا ==
* التابع <code>[[Python/ZipFile/open|ZipFile.open()‎]]</code>: يتيح التابع الوصول إلى عضو في الأرشيف ككائن ثنائي شبيه بالملفات.

== مصادر ==
[https://docs.python.org/3/library/zipfile.html#zipfile.ZipFile.read صفحة Work with ZIP archives في توثيق بايثون الرسمي.]

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