الفرق بين المراجعتين لصفحة: «Python/ZipFile/read»
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE:التابع <code>ZipFile.read()</code> في بايثون}}</noinclude> يعيد التابع البايتات التابعة للمل...' |
لا ملخص تعديل |
||
| سطر 8: | سطر 8: | ||
ZipFile.read(name, pwd=None) | ZipFile.read(name, pwd=None) | ||
</syntaxhighlight> | </syntaxhighlight> | ||
pwd | == المعاملات == | ||
كلمة المرور المستخدمة للملفات المعماة، وإن جرى تعيين قيمة لهذا المعامل فإنّها ستعيد تعريف override كلمة المرور الافتراضية المعيّنة بواسطة التابع setpassword(). | |||
=== <code>name</code> === | |||
اسم الملف في الأرشيف، أو كائن <code>[[Python/ZipInfo|ZipInfo]]</code>. يجب أن يكون الأرشيف مفتوحًا للقراءة أو للإلحاق. | |||
=== <code>pwd</code> === | |||
كلمة المرور المستخدمة للملفات المعماة، وإن جرى تعيين قيمة لهذا المعامل فإنّها ستعيد تعريف override كلمة المرور الافتراضية المعيّنة بواسطة التابع <code>[[Python/ZipFile/setpassword|setpassword()]]</code>. | |||
== القيمة المعادة == | == القيمة المعادة == | ||
| سطر 20: | سطر 21: | ||
يعيد التابع البايتات التابعة للملف المعطى في الأرشيف. | يعيد التابع البايتات التابعة للملف المعطى في الأرشيف. | ||
يؤدي استدعاء التابع read() على كائن ZipFile يستخدم طريقة ضغط غير الطريقة ZIP_STORED أو ZIP_DEFLATED أو ZIP_BZIP2 أو ZIP_LZMA إلى إطلاق الاستثناء NotImplementedError. كذلك تُطلق اللغة خطأ إن كانت الوحدة المقابلة لطريقة الضغط غير متاحة. | يؤدي استدعاء التابع <code>read()</code> على كائن <code>[[Python/ZipFile|ZipFile]]</code> يستخدم طريقة ضغط غير الطريقة <code>ZIP_STORED</code> أو <code>ZIP_DEFLATED</code> أو <code>ZIP_BZIP2</code> أو <code>ZIP_LZMA</code> إلى إطلاق الاستثناء <code>NotImplementedError</code>. كذلك تُطلق اللغة خطأ إن كانت الوحدة المقابلة لطريقة الضغط غير متاحة. | ||
'''ملاحظة:''' | '''ملاحظة:''' | ||
يؤدي استدعاء التابع read() على كائن ZipFile مغلق إلى إطلاق الاستثناء ValueError في الإصدار 3.6 من بايثون. كان التابع يطلق الاستثناء RuntimeError في الإصدارات السابقة. | يؤدي استدعاء التابع <code>read</code>() على كائن <code>ZipFile</code> مغلق إلى إطلاق الاستثناء <code>ValueError</code> في الإصدار 3.6 من بايثون. كان التابع يطلق الاستثناء <code>RuntimeError</code> في الإصدارات السابقة. | ||
== أمثلة == | == أمثلة == | ||
المراجعة الحالية بتاريخ 08:27، 16 نوفمبر 2018
يعيد التابع البايتات التابعة للملف المعطى في الأرشيف.
البنية العامة
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(): يتيح التابع الوصول إلى عضو في الأرشيف ككائن ثنائي شبيه بالملفات.