الفرق بين المراجعتين ل"Python/Decompress/decompress"
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE:التابع <code>Decompress.decompress()</code> في بايثون}}</noinclude> | <noinclude>{{DISPLAYTITLE:التابع <code>Decompress.decompress()</code> في بايثون}}</noinclude> | ||
| − | يفكّ التابع الضغط عن البيانات المعطاة، ويعيد [[Python/bytes|كائن <code>bytes</code>]] يتضمّن البيانات مفكوكة الضغط والمرتبطة على الأقل بجزء من البيانات في السلسلة النصية string. | + | يفكّ التابع الضغط عن البيانات المعطاة، ويعيد [[Python/bytes|كائن <code>bytes</code>]] يتضمّن البيانات مفكوكة الضغط والمرتبطة على الأقل بجزء من البيانات في [[Python/str|السلسلة النصية]] <code>string</code>. |
== البنية العامة == | == البنية العامة == | ||
| سطر 18: | سطر 18: | ||
معامل اختياري. إن أخذ هذا المعامل قيمة غير صفرية فإنّ القيمة المعادة من التابع لن تتجاوز في طولها العدد المحدّد. وهذا يعني أنّه يمكن عدم معالجة جميع المدخلات المضغوطة، وستُحفظ البيانات غير المستهلكة في الخاصية <code>[[Python/zlib#.D8.A7.D9.84.D8.AE.D8.A7.D8.B5.D9.8A.D8.A9 Decompress.unconsumed tail.E2.80.8E|unconsumed_tail]]</code>. يجب تمرير سلسلة البايتات هذه إلى استدعاء لاحق للتابع <code>decompress()</code> إن كانت عملية فك الضغط مستمرّة. أمّا لو أخذ المعامل <code>max_length</code> القيمة (<code>0</code>) فإنّ التابع سيفكّ ضغط المدخلات بأكلمها، وتكون الخاصية <code>[[Python/zlib#.D8.A7.D9.84.D8.AE.D8.A7.D8.B5.D9.8A.D8.A9 Decompress.unconsumed tail.E2.80.8E|unconsumed_tail]]</code> فارغة. | معامل اختياري. إن أخذ هذا المعامل قيمة غير صفرية فإنّ القيمة المعادة من التابع لن تتجاوز في طولها العدد المحدّد. وهذا يعني أنّه يمكن عدم معالجة جميع المدخلات المضغوطة، وستُحفظ البيانات غير المستهلكة في الخاصية <code>[[Python/zlib#.D8.A7.D9.84.D8.AE.D8.A7.D8.B5.D9.8A.D8.A9 Decompress.unconsumed tail.E2.80.8E|unconsumed_tail]]</code>. يجب تمرير سلسلة البايتات هذه إلى استدعاء لاحق للتابع <code>decompress()</code> إن كانت عملية فك الضغط مستمرّة. أمّا لو أخذ المعامل <code>max_length</code> القيمة (<code>0</code>) فإنّ التابع سيفكّ ضغط المدخلات بأكلمها، وتكون الخاصية <code>[[Python/zlib#.D8.A7.D9.84.D8.AE.D8.A7.D8.B5.D9.8A.D8.A9 Decompress.unconsumed tail.E2.80.8E|unconsumed_tail]]</code> فارغة. | ||
| + | |||
| + | '''ملاحظة:''' أصبح بالإمكان استخدام المعامل <code>max_length</code> [[Python/arguments|كمعامل مفتاحي]] في الإصدار 3.6 من بايثون. | ||
| + | |||
| + | == القيمة المعادة == | ||
| + | يعيد [[Python/bytes|كائن <code>bytes</code>]] يتضمّن البيانات مفكوكة الضغط والمرتبطة على الأقل بجزء من البيانات في السلسلة النصية <code>string</code>. | ||
== انظر أيضًا == | == انظر أيضًا == | ||
المراجعة الحالية بتاريخ 17:39، 9 نوفمبر 2018
يفكّ التابع الضغط عن البيانات المعطاة، ويعيد كائن bytes يتضمّن البيانات مفكوكة الضغط والمرتبطة على الأقل بجزء من البيانات في السلسلة النصية string.
البنية العامة
Decompress.decompress(data, max_length=0)
المعاملات
data
البيانات المراد فك الضغط عنها.
max_length
معامل اختياري. إن أخذ هذا المعامل قيمة غير صفرية فإنّ القيمة المعادة من التابع لن تتجاوز في طولها العدد المحدّد. وهذا يعني أنّه يمكن عدم معالجة جميع المدخلات المضغوطة، وستُحفظ البيانات غير المستهلكة في الخاصية unconsumed_tail. يجب تمرير سلسلة البايتات هذه إلى استدعاء لاحق للتابع decompress() إن كانت عملية فك الضغط مستمرّة. أمّا لو أخذ المعامل max_length القيمة (0) فإنّ التابع سيفكّ ضغط المدخلات بأكلمها، وتكون الخاصية unconsumed_tail فارغة.
ملاحظة: أصبح بالإمكان استخدام المعامل max_length كمعامل مفتاحي في الإصدار 3.6 من بايثون.
القيمة المعادة
يعيد كائن bytes يتضمّن البيانات مفكوكة الضغط والمرتبطة على الأقل بجزء من البيانات في السلسلة النصية string.
انظر أيضًا
- التابع
Compress.compress(): يضغط التابع البيانات المعطاة ويعيد كائنbytesيحتوي على البيانات المضغوطة لجزء من البيانات المعطاة على الأقل.