الدالة bz2.open() في بايثون
تفتح الدالة ملفًّا مضغوطًا بخوارزمية bzip2 في النمط الثنائي أو النصي، وتعيد كائن ملف، وهي دالة بانية للصنف BZ2File.
البنية العامة
bz2.open(filename, mode='r', compresslevel=9, encoding=None, errors=None, newline=None)
المعاملات
filename
يمكن لهذا المعامل أن يكون اسم ملف (سلسلة نصية أو كائن bytes)، أو كائن ملفّ تجري القراءة منه والكتابة فيه.
mode
يمكن يأخذ المعامل mode إحدى القيم التالية: 'r'، 'rb'، 'w'، 'wb'، 'x'، 'xb'، 'a'، 'ab' للنمط الثنائي، والقيم 'rt'، 'wt'، 'xt'، 'at' للنمط النصي، والقيمة الافتراضية لهذا المعامل هي 'rb'.
compresslevel
عدد صحيح يتدرج من 1 إلى 9 ويؤدي نفس الوظيفة التي يؤديها في الدالة البانية للصنف BZ2File.
تكافئ هذه الدالة في الوضع الثنائي الدالة البانية للصنف BZ2File، وعند استخدام هذا الوضع يجب أن لا تُمرّر قيم للمعاملات encoding و errors و newline.
أما في الوضع النصي يجري إنشاء كائن BZ2File وتغليفه بنسخة من الصنف io.TextIOWrapper مع القيم المحددة للترميز والتعامل مع الأخطاء ونهايات الأسطر.
ملاحظات:
- هذه الدالة جديدة في الإصدار 3.3.
- أضيف النمط
'x'(الإنشاء الخاص exclusive creation) في الإصدار 3.4 من بايثون. - تستقبل الدالة الكائنات الشبيهة بالمسارات في الإصدار 3.6 من بايثون.
القيمة المعادة
تعيد الدالة كائن ملف.