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

من موسوعة حسوب
→ التعديل السابق
مرئينص الويكي
لا ملخص تعديل
 
(5 مراجعات متوسطة بواسطة نفس المستخدم غير معروضة)
سطر 4: سطر 4:


تتضمّن وحدة <code>bz2</code> ما يلي:
تتضمّن وحدة <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/bz2/open|bz2.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>]])، أو كائن ملفّ تجري القراءة منه والكتابة فيه.
== عمليات الضغط وفك الضغط التزايدية Incremental ==


=== <code>mode</code> ===
=== الصنف <code>[[Python/BZ2Compressor|BZ2Compressor]]</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> ===
يعيد التابع البيانات المخزنة في الذاكرة دون التحرّك في موقع الملف.
 
'''ملاحظات'''
 
<nowiki>*</nowiki> صحيح أن استدعاء التابع <code>peek()</code>‎ لا يؤدي إلى تغيير موقع الملف في كائن <code>BZ2File</code>، إلا أنّه قد يغيّر الموقع في كائن الملف الداخلي (مثال: عند بناء الصنف <code>BZ2File</code> عن طريق تمرير كائن ملف كقيمة للمعامل <code>filename</code>). يظهر هذا السلوك في الإصدار 3.3 من بايثون.
 
<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> ===
تنشئ هذه الدالة البانية كائن compressor جديد، ويمكن استخدام هذا الكائن لضغط البيانات تزايدياً.
تنشئ هذه الدالة البانية كائن compressor جديد، ويمكن استخدام هذا الكائن لضغط البيانات تزايدياً.


=== الصنف <code>BZ2Decompressor</code> ===
=== الصنف <code>[[Python/BZ2Decompressor|BZ2Decompressor]]</code> ===
تنشئ هذه الدالة البانية كائن decompressor الذي يمكن استخدامه لفك الضغط عن البيانات تزايديًا.
تنشئ هذه الدالة البانية كائن 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> ===
تفكّ الدالة الضغط عن البيانات المعطاة.
تفكّ الدالة الضغط عن البيانات المعطاة.
== انظر أيضًا ==
* [[Python/lzma|الوحدة <code>lzma</code>]]: تقدّم هذه الوحدة مجموعة من الأصناف والدوال المساعدة لإجراء عمليات ضغط البيانات وفك الضغط عنها باستخدام خوارزمية الضغط LZMA.
* [[Python/gzip|الوحدة <code>gzip</code>]]: تقدّم هذه الوحدة واجهة بسيطة لضغط الملفات وفك ضغطها بنفس الأسلوب المتّبع في برنامجي gzip و gunzip في GNU.


== مصادر ==
== مصادر ==

المراجعة الحالية بتاريخ 13:21، 10 نوفمبر 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()‎

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

انظر أيضًا

  • الوحدة lzma: تقدّم هذه الوحدة مجموعة من الأصناف والدوال المساعدة لإجراء عمليات ضغط البيانات وفك الضغط عنها باستخدام خوارزمية الضغط LZMA.
  • الوحدة gzip: تقدّم هذه الوحدة واجهة بسيطة لضغط الملفات وفك ضغطها بنفس الأسلوب المتّبع في برنامجي gzip و gunzip في GNU.

مصادر

مجلوبة من «https://wiki.hsoub.com/index.php?title=Python/bz2&oldid=23083»