الفرق بين المراجعتين لصفحة: «Python/zlib/compress»
أنشأ الصفحة ب'<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) | المعامل <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 في توثيق بايثون الرسمي.