التابع ZipFile.read() في بايثون
يعيد التابع البايتات التابعة للملف المعطى في الأرشيف.
البنية العامة
ZipFile.read(name, pwd=None)
المعاملات
name اسم الملف في الأرشيف، أو كائن ZipInfo. يجب أن يكون الأرشيف مفتوحًا للقراءة أو للإلحاق.
pwd كلمة المرور المستخدمة للملفات المعماة، وإن جرى تعيين قيمة لهذا المعامل فإنّها ستعيد تعريف override كلمة المرور الافتراضية المعيّنة بواسطة التابع setpassword().
القيمة المعادة
يعيد التابع البايتات التابعة للملف المعطى في الأرشيف.
يؤدي استدعاء التابع read() على كائن ZipFile يستخدم طريقة ضغط غير الطريقة ZIP_STORED أو ZIP_DEFLATED أو ZIP_BZIP2 أو ZIP_LZMA إلى إطلاق الاستثناء NotImplementedError. كذلك تُطلق اللغة خطأ إن كانت الوحدة المقابلة لطريقة الضغط غير متاحة.
ملاحظة:
يؤدي استدعاء التابع read() على كائن ZipFile مغلق إلى إطلاق الاستثناء ValueError في الإصدار 3.6 من بايثون. كان التابع يطلق الاستثناء RuntimeError في الإصدارات السابقة.
أمثلة
يبين المثال التالي آلية عمل التابع:
>>> import zipfile
>>> zip = zipfile.ZipFile('files.zip')
>>> zip.read('file1.txt')
b'Hsoub Wiki.\n'
انظر أيضًا
- التابع
ZipFile.open(): يتيح التابع الوصول إلى عضو في الأرشيف ككائن ثنائي شبيه بالملفات.