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

من موسوعة حسوب
سطر 20: سطر 20:


يقدّم الصنف [[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/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/BZ2File|<code>BZ2File</code>]] كذلك التوابع التالية:
=== التابع <code>[[Python/BZ2File/peek|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 من بايثون.


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

مراجعة 20:06، 9 نوفمبر 2018


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

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

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

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

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

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

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

‎الصنف BZ2File

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

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

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

الصنف BZ2Compressor

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

الصنف BZ2Decompressor

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

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

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

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

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

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

مصادر