الفرق بين المراجعتين لصفحة: «Python/bz2»

→ التعديل السابق التعديل اللاحق ←

مرئينص الويكي

مراجعة 18:51، 9 نوفمبر 2018

تقدّم هذه الوحدة واجهة متكاملة لضغط البيانات وفك الضغط عنها باستخدام خوارزمية الضغط bzip2.

تتضمّن وحدة bz2 ما يلي:

دالة open()‎ وصنف BZ2File لقراءة الملفات المضغوطة والكتابة فيها.
صنفا BZ2Compressor و BZ2Decompressor لإجراء عمليات الضغط وفك الضغط التزايدي incremental.
دالتا compress()‎ و decompress()‎ لإجراء عمليات الضغط وفك الضغط بخطوة واحدة.

يجدر التنبيه إلى إمكانية الوصول إلى جميع الأصناف في هذه الوحدة بأمان من خيوط متعددة.

ضغط البيانات وفكّ الضغط عنها

الدالة `bz.open()‎`

تفتح الدالة ملفًّا مضغوطًا بخوارزمية bzip2 في النمط الثنائي أو النصي، وتعيد كائن ملف، وهي دالة بانية للصنف BZ2File.

‎الصنف `BZ2File`

يستخدم هذا الصنف لقراءة الملفات المضغوطة والكتابة فيها.

يقدّم الصنف BZ2File جميع التوابع المقدّمة من الصنف io.BufferedIOBase باستثناء التابعين detach()‎ و truncate()‎، ويدعم الصنف BZ2File التكرار iteration وعبارات with.

تقدّم كائنات BZ2File كذلك التوابع التالية:

التابع `peek()‎`

يعيد التابع البيانات المخزنة في الذاكرة دون التحرّك في موقع الملف.

ملاحظات

صحيح أن استدعاء التابع peek()‎‎ لا يؤدي إلى تغيير موقع الملف في كائن BZ2File، إلا أنّه قد يغيّر الموقع في كائن الملف الداخلي (مثال: عند بناء الصنف BZ2File عن طريق تمرير كائن ملف كقيمة للمعامل filename). يظهر هذا السلوك في الإصدار 3.3 من بايثون.
أضيف دعم عبارات with في الإصدار 3.1 من بايثون.
أضيفت التوابع fileno()‎ و readable()‎ و seekable()‎ و writable()‎ و read1()‎ و readinto()‎ في الإصدار 3.3 من بايثون.
أصبح بالإمكان في الإصدار 3.3 من بايثون استخدام كائن ملف كقيمة للمعامل filename عوضًا عن اسم ملف حقيقي.
أضيف النمط 'a' (الإلحاق append) إلى جانب إضافة دعم قراءة الملفات ذات التدفقات المتعددة في الإصدار 3.3 من بايثون.
أضيف النمط 'x' (الإنشاء الخاص exclusive creation) في الإصدار 3.4 من بايثون.
في الإصدار 3.5 من بايثون أصبح التابع read()‎ يستقبل معاملًا يأخذ القيمة None.
أصبح بالإمكان تمرير كائن شبيه بالملفات إلى الدالة البانية في الإصدار 3.6 من بايثون.

عمليات الضغط وفك الضغط التزايدية Incremental

الصنف `BZ2Compressor`

تنشئ هذه الدالة البانية كائن compressor جديد، ويمكن استخدام هذا الكائن لضغط البيانات تزايدياً.

الصنف `BZ2Decompressor`

تنشئ هذه الدالة البانية كائن decompressor الذي يمكن استخدامه لفك الضغط عن البيانات تزايديًا.

عمليات الضغط وفك الضغط التي تجري دفعة واحدة One-shot

الدالة `bz2.compress()‎`

تضغط الدالة البيانات المعطاة.

الدالة `bz2.decompress()‎`

تفكّ الدالة الضغط عن البيانات المعطاة.

مصادر

صفحة Support for bzip2 compression في توثيق بايثون الرسمي.

@@ سطر 4: / سطر 4: @@
 تتضمّن وحدة <code>bz2</code> ما يلي:
-* دالة <code>open()‎</code> وصنف <code>BZ2File</code> لقراءة الملفات المضغوطة والكتابة فيها.
+* دالة <code>[[Python/bz2/open|open()‎]]</code> وصنف [[Python/BZ2File|<code>BZ2File</code>]] لقراءة الملفات المضغوطة والكتابة فيها.
-* صنفا <code>BZ2Compressor</code> و <code>BZ2Decompressor</code> لإجراء عمليات الضغط وفك الضغط التزايدي incremental.
+* صنفا [[Python/BZ2Compressor|<code>BZ2Compressor</code>]] و [[Python/BZ2Decompressor|<code>BZ2Decompressor</code>]] لإجراء عمليات الضغط وفك الضغط التزايدي incremental.
-* دالتا <code>compress()‎</code> و <code>decompress()‎</code> لإجراء عمليات الضغط وفك الضغط بخطوة واحدة.
+* دالتا <code>[[Python/bz2/compress|compress()‎]]</code> و <code>[[Python/bz2/decompress|decompress()]]‎</code> لإجراء عمليات الضغط وفك الضغط بخطوة واحدة.
 يجدر التنبيه إلى إمكانية الوصول إلى جميع الأصناف في هذه الوحدة بأمان من خيوط متعددة.
-== البنية العامة ==
+== ضغط البيانات وفكّ الضغط عنها ==
-<syntaxhighlight lang="python3">
+=== الدالة <code>[[Python/bz/open|bz.open()‎]]</code> ===
-bz2.open(filename, mode='r', compresslevel=9, encoding=None, errors=None, newline=None)
+تفتح الدالة ملفًّا مضغوطًا بخوارزمية bzip2 في النمط الثنائي أو النصي، وتعيد كائن ملف، وهي دالة بانية للصنف [[Python/BZ2File|<code>BZ2File</code>]].
-</syntaxhighlight>
-تفتح الدالة ملفًّا مضغوطًا بخوارزمية bzip2 في النمط الثنائي أو النصي، وتعيد كائن ملف، وهي دالة بانية للصنف <code>BZ2File</code>.
+== ‎الصنف <code>[[Python/BZ2File|BZ2File]]</code> ==
-== ‎المعاملات ==
+يستخدم هذا الصنف لقراءة الملفات المضغوطة والكتابة فيها.
-=== <code>filename</code> ===
+يقدّم الصنف [[Python/BZ2File|<code>BZ2File</code>]] جميع التوابع المقدّمة من الصنف <code>[[Python/io/BufferedIOBase|io.BufferedIOBase]]</code> باستثناء التابعين <code>detach()</code>‎ و <code>truncate()</code>‎، ويدعم الصنف [[Python/BZ2File|<code>BZ2File</code>]] التكرار iteration وعبارات <code>with</code>.
-يمكن لهذا املعامل أن يكون اسم ملف ([[Python/str|سلسلة نصية]] أو [[Python/bytes|كائن <code>bytes</code>]])، أو كائن ملفّ تجري القراءة منه والكتابة فيه.
+تقدّم كائنات [[Python/BZ2File|<code>BZ2File</code>]] كذلك التوابع التالية:
-=== <code>mode</code> ===
+=== التابع <code>[[Python/BZ2File/peek|peek()‎]]</code> ===
-يأخذ المعامل mode إحدى القيم التالية: ‎<code>'r'</code>، <code>'rb'</code>، <code>'w'</code>، <code>'wb'</code>، <code>'x'</code>، <code>'xb'</code>، <code>'a'</code>، <code>'ab'</code>‎ للنمط الثنائي، والقيم ‎<code>'rt'</code>، <code>'wt'</code>، <code>'xt'</code>، <code>'at'</code>‎ للنمط النصي، والقيمة الافتراضية لهذا المعامل هي <code>'rb'</code>.
-=== <code>compresslevel</code> ===
-عدد صحيح يتدرج من <code>1</code> إلى <code>9</code> ويؤدي نفس الوظيفة التي يؤديها في الدالة البانية للصنف <code>BZ2File</code>.
-تكافئ هذه الدالة في الوضع الثنائي الدالة البانية للصنف <code>BZ2File</code>:
-<syntaxhighlight lang="python3">
-BZ2File(filename, mode, compresslevel=compresslevel)
-</syntaxhighlight>
-وفي هذه الحالة يجب عدم تمرير قيم للمعاملات <code>encoding</code> و <code>errors</code> و <code>newline</code>.
-أما في الوضع النصي يجري إنشاء كائن <code>BZ2File</code> وتغليفه بنسخة من الصنف <code>io.TextIOWrapper</code> مع القيم المحددة للترميز والتعامل مع الأخطاء ونهايات الأسطر.
-'''ملاحظات:'''
-* هذه الدالة جديدة في الإصدار 3.3.
-* أضيف النمط <code>'x'</code> (الإنشاء الخاص exclusive creation) في الإصدار 3.4 من بايثون.
-* تستقبل الدالة الكائنات الشبيهة بالمسارات في الإصدار 3.6 من بايثون.
-== الصنف BZ2File ==
-تفتح الدالة ملفًّا مضغوطًا بخوارزمية bzip2 في النمط الثنائي.
-يقدّم الصنف <code>BZ2File</code> جميع التوابع المقدّمة من الصنف <code>io.BufferedIOBase</code> باستثناء التابعين <code>detach()</code>‎ و <code>truncate()</code>‎، ويدعم الصنف <code>BZ2File</code> التكرار iteration وعبارات <code>with</code>.
-تقدّم كائنات <code>BZ2File</code> كذلك التوابع التالية:
-=== التابع <code>peek()‎</code> ===
 يعيد التابع البيانات المخزنة في الذاكرة دون التحرّك في موقع الملف.
 '''ملاحظات'''
+* صحيح أن استدعاء التابع [[Python/BZ2File/peek|<code>peek()‎</code>]]‎ لا يؤدي إلى تغيير موقع الملف في كائن [[Python/BZ2File|<code>BZ2File</code>]]، إلا أنّه قد يغيّر الموقع في كائن الملف الداخلي (مثال: عند بناء الصنف [[Python/BZ2File|<code>BZ2File</code>]] عن طريق تمرير كائن ملف كقيمة للمعامل <code>filename</code>). يظهر هذا السلوك في الإصدار 3.3 من بايثون.
+* أضيف دعم عبارات <code>with</code> في الإصدار 3.1 من بايثون.
+* أضيفت التوابع <code>fileno()‎</code> و <code>readable()</code>‎ و <code>seekable()</code>‎ و <code>writable()</code>‎ و <code>read1()</code>‎ و <code>readinto()</code>‎ في الإصدار 3.3 من بايثون.
+* أصبح بالإمكان في الإصدار 3.3 من بايثون استخدام كائن ملف كقيمة للمعامل <code>filename</code> عوضًا عن اسم ملف حقيقي.
+* أضيف النمط <code>'a'</code> (الإلحاق append) إلى جانب إضافة دعم قراءة الملفات ذات التدفقات المتعددة في الإصدار 3.3 من بايثون.
+* أضيف النمط <code>'x'</code> (الإنشاء الخاص exclusive creation) في الإصدار 3.4 من بايثون.
+* في الإصدار 3.5 من بايثون أصبح التابع <code>read()</code>‎ يستقبل معاملًا يأخذ القيمة <code>None</code>.
+* أصبح بالإمكان تمرير كائن شبيه بالملفات إلى الدالة البانية في الإصدار 3.6 من بايثون.
-<nowiki>*</nowiki> صحيح أن استدعاء التابع <code>peek()</code>‎ لا يؤدي إلى تغيير موقع الملف في كائن <code>BZ2File</code>، إلا أنّه قد يغيّر الموقع في كائن الملف الداخلي (مثال: عند بناء الصنف <code>BZ2File</code> عن طريق تمرير كائن ملف كقيمة للمعامل <code>filename</code>). يظهر هذا السلوك في الإصدار 3.3 من بايثون.
+== عمليات الضغط وفك الضغط التزايدية Incremental ==
-<nowiki>*</nowiki> أضيف دعم عبارات <code>with</code> في الإصدار 3.1 من بايثون.
-<nowiki>*</nowiki> أضيفت التوابع <code>fileno()‎</code> و <code>readable()</code>‎ و <code>seekable()</code>‎ و <code>writable()</code>‎ و <code>read1()</code>‎ و <code>readinto()</code>‎ في الإصدار 3.3 من بايثون.
-<nowiki>*</nowiki> أصبح بالإمكان في الإصدار 3.3 من بايثون استخدام كائن ملف كقيمة للمعامل <code>filename</code> عوضًا عن اسم ملف حقيقي.
-<nowiki>*</nowiki> أضيف النمط <code>'a'</code> (الإلحاق append) إلى جانب إضافة دعم قراءة الملفات ذات التدفقات المتعددة في الإصدار 3.3 من بايثون.
-<nowiki>*</nowiki> أضيف النمط <code>'x'</code> (الإنشاء الخاص exclusive creation) في الإصدار 3.4 من بايثون.
-<nowiki>*</nowiki> في الإصدار 3.5 من بايثون أصبح التابع <code>read()</code>‎ يستقبل معاملًا يأخذ القيمة <code>None</code>.
-<nowiki>*</nowiki> أصبح بالإمكان تمرير كائن شبيه بالملفات إلى الدالة البانية في الإصدار 3.6 من بايثون.
-== عمليات الضغط وفك الضغط التزايدية ==
-=== الصنف <code>BZ2Compressor</code> ===
+=== الصنف <code>[[Python/BZ2Compressor|BZ2Compressor]]</code> ===
 تنشئ هذه الدالة البانية كائن compressor جديد، ويمكن استخدام هذا الكائن لضغط البيانات تزايدياً.
-=== الصنف <code>BZ2Decompressor</code> ===
+=== الصنف <code>[[Python/BZ2Decompressor|BZ2Decompressor]]</code> ===
 تنشئ هذه الدالة البانية كائن decompressor الذي يمكن استخدامه لفك الضغط عن البيانات تزايديًا.
-== عمليات الضغط وفك الضغط التي تجري دفعة واحدة ==
+== عمليات الضغط وفك الضغط التي تجري دفعة واحدة One-shot ==
-=== الدالة <code>bz2.compress()‎</code> ===
+=== الدالة <code>[[Python/bz2/compress|bz2.compress()‎]]</code> ===
 تضغط الدالة البيانات المعطاة.
-=== الدالة <code>bz2.decompress()‎</code> ===
+=== الدالة <code>[[Python/bz2/decompress|bz2.decompress()‎]]</code> ===
 تفكّ الدالة الضغط عن البيانات المعطاة.

مراجعة 18:51، 9 نوفمبر 2018

ضغط البيانات وفكّ الضغط عنها

الدالة bz.open()‎

‎الصنف BZ2File

التابع peek()‎