الفرق بين المراجعتين لصفحة: «Python/Decompress/decompress»
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE:التابع <code>Decompress.decompress()</code> في بايثون}}</noinclude> يفكّ التابع الضغط عن البيانات ا...' |
لا ملخص تعديل |
||
| (1 مراجعات متوسطة بواسطة نفس المستخدم غير معروضة) | |||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE:التابع <code>Decompress.decompress()</code> في بايثون}}</noinclude> | <noinclude>{{DISPLAYTITLE:التابع <code>Decompress.decompress()</code> في بايثون}}</noinclude> | ||
يفكّ التابع الضغط عن البيانات المعطاة، ويعيد كائن bytes يتضمّن البيانات مفكوكة الضغط والمرتبطة على الأقل بجزء من البيانات في السلسلة النصية string. | يفكّ التابع الضغط عن البيانات المعطاة، ويعيد [[Python/bytes|كائن <code>bytes</code>]] يتضمّن البيانات مفكوكة الضغط والمرتبطة على الأقل بجزء من البيانات في [[Python/str|السلسلة النصية]] <code>string</code>. | ||
== البنية العامة == | == البنية العامة == | ||
| سطر 17: | سطر 17: | ||
=== <code>max_length</code> === | === <code>max_length</code> === | ||
معامل اختياري. إن أخذ هذا المعامل قيمة غير صفرية فإنّ القيمة المعادة من التابع لن تتجاوز في طولها العدد المحدّد. وهذا يعني أنّه يمكن عدم معالجة جميع المدخلات المضغوطة، وستُحفظ البيانات غير المستهلكة في الخاصية unconsumed_tail. يجب تمرير سلسلة البايتات هذه إلى استدعاء لاحق للتابع decompress() إن كانت عملية فك الضغط مستمرّة. أمّا لو أخذ المعامل max_length القيمة ( | معامل اختياري. إن أخذ هذا المعامل قيمة غير صفرية فإنّ القيمة المعادة من التابع لن تتجاوز في طولها العدد المحدّد. وهذا يعني أنّه يمكن عدم معالجة جميع المدخلات المضغوطة، وستُحفظ البيانات غير المستهلكة في الخاصية <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>. | |||
== انظر أيضًا == | == انظر أيضًا == | ||
* التابع <code>[[Python/Compress/compress|Compress.compress()]]</code>: يضغط التابع البيانات المعطاة ويعيد كائن bytes يحتوي على البيانات المضغوطة لجزء من البيانات المعطاة على الأقل. | * التابع <code>[[Python/Compress/compress|Compress.compress()]]</code>: يضغط التابع البيانات المعطاة ويعيد [[Python/bytes|كائن <code>bytes</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يحتوي على البيانات المضغوطة لجزء من البيانات المعطاة على الأقل.