الفرق بين المراجعتين ل"Python/zlib/compress"

من موسوعة حسوب
< Python‏ | zlib
اذهب إلى التنقل اذهب إلى البحث
(أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE:الدالة <code>zlib.compress()‎</code> في بايثون}}</noinclude> تضغط الدالة البايتات المعطاة، وتعي...')
 
 
سطر 1: سطر 1:
 
<noinclude>{{DISPLAYTITLE:الدالة <code>zlib.compress()‎</code> في بايثون}}</noinclude>
 
<noinclude>{{DISPLAYTITLE:الدالة <code>zlib.compress()‎</code> في بايثون}}</noinclude>
  
تضغط الدالة البايتات المعطاة، وتعيد كائن bytes يتضمّن البيانات المضغوطة.  
+
تضغط الدالة البايتات المعطاة، وتعيد [[Python/bytes|كائن <code>bytes</code>]] يتضمّن البيانات المضغوطة.  
  
 
== البنية العامة ==
 
== البنية العامة ==
سطر 8: سطر 8:
 
zlib.compress(data, level=-1)
 
zlib.compress(data, level=-1)
 
</syntaxhighlight>
 
</syntaxhighlight>
+
 
== المعاملات ==
+
== ‎المعاملات ==
  
 
=== <code>level</code> ===
 
=== <code>level</code> ===
  
المعامل level هو عدد صحيح ضمن النطاق 0 إلى 9 أو ‎-1 ووظيفته هي التحكم في مستوى عملية الضغط، فالقيمة 1 (Z_BEST_SPEED) هي الأسرع وتعطي أقل مقدار من الضغط، والقيمة  9 (Z_BEST_COMPRESSION) هي الأبطأ وتنتج أكبر مقدار من الضغط. أما القيمة 0 (Z_NO_COMPRESSION) فتعني عدم ضغط البيانات. القيمة الافتراضية لهذا المعامل هي ‎-1 (Z_DEFAULT_COMPRESSION)‎ وتقدّم هذه القيمة حالة من التوازن بين السرعة ومقدار الضغط (تكافئ هذه القيمة المستوى 6 في الوقت الحاضر).  
+
المعامل <code>level</code> هو [[Python/int|عدد صحيح]] ضمن النطاق <code>0</code> إلى <code>9</code> أو <code>‎-1</code> ووظيفته هي التحكم في مستوى عملية الضغط، فالقيمة <code>1</code> تقابل المستوى<code>(Z_BEST_SPEED)</code> وهو الأسرع ويعطي أقل مقدار من الضغط، والقيمة  <code>9</code>تقابل المستوى<code>(Z_BEST_COMPRESSION)</code> وهو الأبطأ وينتج أكبر مقدار من الضغط. أما القيمة <code>0</code> فتقابل المستوى (<code>Z_NO_COMPRESSION</code>) فتعني عدم ضغط البيانات. القيمة الافتراضية لهذا المعامل هي ‎-1 وتقابل  ‎<code>(Z_DEFAULT_COMPRESSION)</code>‎ وتقدّم هذه القيمة حالة من التوازن بين السرعة ومقدار الضغط (تكافئ هذه القيمة المستوى <code>6</code> في الوقت الحاضر).  
 
 
 
 
 
== القيمة المعادة ==
 
== القيمة المعادة ==
تعيد الدالة كائن bytes يتضمّن البيانات المضغوطة.
+
تعيد الدالة [[Python/bytes|كائن <code>bytes</code>]] يتضمّن البيانات المضغوطة.
  
 
تطلق الدالة استثناءً في حال حدوث أيّ خطأ خلال عملية الضغط.
 
تطلق الدالة استثناءً في حال حدوث أيّ خطأ خلال عملية الضغط.
  
'''ملاحظة:''' في الإصدار 3.6 من بايثون أصبح بالإمكان استخدام المعامل level كمعامل مفتاحي.
+
'''ملاحظة:''' في الإصدار 3.6 من بايثون أصبح بالإمكان استخدام المعامل <code>level</code> [[Python/arguments|كمعامل مفتاحي]].
  
 
== انظر أيضًا ==
 
== انظر أيضًا ==
  
* الدالة zlib.compressobj()‎: تعيد الدالة كائن ضغط يمكن استخدامه لضغط البيانات التي لا يمكن وضعها في الذاكرة دفعة واحدة.
+
* الدالة <code>[[Python/zlib/compressobj|zlib.compressobj()‎]]</code>: تعيد الدالة كائن ضغط يمكن استخدامه لضغط البيانات التي لا يمكن وضعها في الذاكرة دفعة واحدة.
  
 
== مصادر ==
 
== مصادر ==

المراجعة الحالية بتاريخ 16:49، 7 نوفمبر 2018


تضغط الدالة البايتات المعطاة، وتعيد كائن bytes يتضمّن البيانات المضغوطة.

البنية العامة

zlib.compress(data, level=-1)

‎المعاملات

level

المعامل level هو عدد صحيح ضمن النطاق 0 إلى 9 أو ‎-1 ووظيفته هي التحكم في مستوى عملية الضغط، فالقيمة 1 تقابل المستوى(Z_BEST_SPEED) وهو الأسرع ويعطي أقل مقدار من الضغط، والقيمة 9تقابل المستوى(Z_BEST_COMPRESSION) وهو الأبطأ وينتج أكبر مقدار من الضغط. أما القيمة 0 فتقابل المستوى (Z_NO_COMPRESSION) فتعني عدم ضغط البيانات. القيمة الافتراضية لهذا المعامل هي ‎-1 وتقابل ‎(Z_DEFAULT_COMPRESSION)‎ وتقدّم هذه القيمة حالة من التوازن بين السرعة ومقدار الضغط (تكافئ هذه القيمة المستوى 6 في الوقت الحاضر).

القيمة المعادة

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

تطلق الدالة استثناءً في حال حدوث أيّ خطأ خلال عملية الضغط.

ملاحظة: في الإصدار 3.6 من بايثون أصبح بالإمكان استخدام المعامل level كمعامل مفتاحي.

انظر أيضًا

  • الدالة zlib.compressobj()‎: تعيد الدالة كائن ضغط يمكن استخدامه لضغط البيانات التي لا يمكن وضعها في الذاكرة دفعة واحدة.

مصادر

صفحة Compression compatible with gzip في توثيق بايثون الرسمي.