الفرق بين المراجعتين لصفحة: «Python/LZMADecompressor»
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE:الصنف <code>bz2.BZ2Decompressor</code> في بايثون}}</noinclude> تنشئ هذه الدالة البانية كائن decompressor...' |
لا ملخص تعديل |
||
| سطر 3: | سطر 3: | ||
تنشئ هذه الدالة البانية كائن decompressor يمكن استخدامه لفك الضغط عن البيانات تزايديًا. | تنشئ هذه الدالة البانية كائن decompressor يمكن استخدامه لفك الضغط عن البيانات تزايديًا. | ||
يمكن استخدام الدالة decompress() لفك الضغط عن البيانات دفعة واحدة. | يمكن استخدام الدالة <code>[[Python/lzma/decompress|decompress()]]</code> لفك الضغط عن البيانات دفعة واحدة. | ||
'''ملاحظة:''' | '''ملاحظة:''' | ||
| سطر 18: | سطر 18: | ||
=== <code>format</code> === | === <code>format</code> === | ||
يحدّد المعامل format تنسيق الحاوية الذي يجب استخدامه من قبل الدالة البانية. القيمة الافتراضية هي | يحدّد المعامل <code>format</code> تنسيق الحاوية الذي يجب استخدامه من قبل الدالة البانية. القيمة الافتراضية هي <code>FORMAT_AUTO</code>، والتي يمكنها فك الضغط عن ملفات <code>.xz</code> و <code>.lzma</code>، ويمكن أن يأخذ المعامل القيم <code>FORMAT_XZ</code> و <code>FORMAT_ALONE</code> و <code>FORMAT_RAW</code>. | ||
=== <code>memlimit</code> === | === <code>memlimit</code> === | ||
يحدّد هذا المعامل مقدار الذاكرة (بالبايتات) المسموح باستخدامه لفكّ الضغط عن البيانات. عند استخدام هذا المعامل تطلق اللغة الاستثناء LZMAError عندما لا يكون بالإمكان فك الضغط عن المدخلات باستخدام المقدار المحدّد من الذاكرة. | يحدّد هذا المعامل مقدار الذاكرة (بالبايتات) المسموح باستخدامه لفكّ الضغط عن البيانات. عند استخدام هذا المعامل تطلق اللغة الاستثناء <code>LZMAError</code> عندما لا يكون بالإمكان فك الضغط عن المدخلات باستخدام المقدار المحدّد من الذاكرة. | ||
=== <code>filters</code> === | === <code>filters</code> === | ||
يحدّد المعامل filters سلسلة الترشيح التي استُخدمت لإنشاء تدفّق البيانات المراد فك الضغط عنه. يكون هذا المعامل مطلوبًا إن أخذ المعامل format القيمة | يحدّد المعامل <code>filters</code> سلسلة الترشيح التي استُخدمت لإنشاء تدفّق البيانات المراد فك الضغط عنه. يكون هذا المعامل مطلوبًا إن أخذ المعامل <code>format</code> القيمة <code>FORMAT_RAW</code>، ولكن يجب أن لا يُستخدم مع التنسيقات الأخرى. | ||
راجع موضوع تحديد سلاسل ترشيح مخصّصة للمزيد من المعلومات حول سلاسل الترشيح. | راجع [[Python/lzma#.D8.AA.D8.AD.D8.AF.D9.8A.D8.AF .D8.B3.D9.84.D8.A7.D8.B3.D9.84 .D8.AA.D8.B1.D8.B4.D9.8A.D8.AD .D9.85.D8.AE.D8.B5.D9.91.D8.B5.D8.A9|موضوع تحديد سلاسل ترشيح مخصّصة]] للمزيد من المعلومات حول سلاسل الترشيح. | ||
== توابع الصنف <code>LZMADecompressor</code> == | == توابع الصنف <code>LZMADecompressor</code> == | ||
| سطر 40: | سطر 40: | ||
=== <code>check</code> === | === <code>check</code> === | ||
معرّف اختبار السلامة المستخدم بواسطة تدفّق البيانات المدخل. يمكن أن تأخذ هذه الخاصية القيمة CHECK_UNKNOWN إلى حين فك ترميز ما يكفي من المدخلات لتحدد نوع اختبار السلامة المستخدم. | معرّف اختبار السلامة المستخدم بواسطة تدفّق البيانات المدخل. يمكن أن تأخذ هذه الخاصية القيمة <code>CHECK_UNKNOWN</code> إلى حين فك ترميز ما يكفي من المدخلات لتحدد نوع اختبار السلامة المستخدم. | ||
=== <code>eof</code> === | === <code>eof</code> === | ||
المراجعة الحالية بتاريخ 18:09، 12 نوفمبر 2018
تنشئ هذه الدالة البانية كائن decompressor يمكن استخدامه لفك الضغط عن البيانات تزايديًا.
يمكن استخدام الدالة decompress() لفك الضغط عن البيانات دفعة واحدة.
ملاحظة:
لا يتعامل هذا الصنف بطريقة واضحة مع المدخلات التي تتضمّن مجموعة من تدفّقات البيانات المضغوطة مخالفًا في ذلك الدالة decompress() والصنف LZMAFile. إن كنت بحاجة إلى فك الضغط عن مجموعة من التدفّقات المضغوطة باستخدام الصنف LZMADecompressor فيجب عليك استخدام كائن decompressor جديد مع كل تدفّق للبيانات.
البنية العامة
lzma.LZMADecompressor(format=FORMAT_AUTO, memlimit=None, filters=None)
المعاملات
format
يحدّد المعامل format تنسيق الحاوية الذي يجب استخدامه من قبل الدالة البانية. القيمة الافتراضية هي FORMAT_AUTO، والتي يمكنها فك الضغط عن ملفات .xz و .lzma، ويمكن أن يأخذ المعامل القيم FORMAT_XZ و FORMAT_ALONE و FORMAT_RAW.
memlimit
يحدّد هذا المعامل مقدار الذاكرة (بالبايتات) المسموح باستخدامه لفكّ الضغط عن البيانات. عند استخدام هذا المعامل تطلق اللغة الاستثناء LZMAError عندما لا يكون بالإمكان فك الضغط عن المدخلات باستخدام المقدار المحدّد من الذاكرة.
filters
يحدّد المعامل filters سلسلة الترشيح التي استُخدمت لإنشاء تدفّق البيانات المراد فك الضغط عنه. يكون هذا المعامل مطلوبًا إن أخذ المعامل format القيمة FORMAT_RAW، ولكن يجب أن لا يُستخدم مع التنسيقات الأخرى.
راجع موضوع تحديد سلاسل ترشيح مخصّصة للمزيد من المعلومات حول سلاسل الترشيح.
توابع الصنف LZMADecompressor
تقدّم كائنات LZMADecompressor التوابع التالية:
التابع decompress()
يفكّ التابع الضغط عن البيانات المعطاة (كائن شبيه بالبايتات bytes-like) ويعيد البيانات الناتجة عن عملية فك الضغط على هيئة بايتات.
خصائص الصنف LZMADecompressor
تمتلك كائنات LZMADecompressor الخصائص التالية:
check
معرّف اختبار السلامة المستخدم بواسطة تدفّق البيانات المدخل. يمكن أن تأخذ هذه الخاصية القيمة CHECK_UNKNOWN إلى حين فك ترميز ما يكفي من المدخلات لتحدد نوع اختبار السلامة المستخدم.
eof
تأخذ هذه الخاصية القيمة True عند الوصول إلى نهاية تدفّق البيانات.
ملاحظة: هذه الخاصية جديدة في الإصدار 3.3 من بايثون.
unused_data
تُخزّن البيانات التي يُعثر عليها بعد نهاية تدفق البيانات المضغوط في هذه الخاصية.
تحمل هذه الخاصية القيمة b'' إن طُلبت قيمتها قبل الوصول إلى نهاية تدفق البيانات.
needs_input
تحمل هذه الخاصية القيمة False إن كان بمقدور التابع decompress() أن يقدّم المزيد من البيانات التي أزيل الضغط عنها قبل طلب بيانات جديدة غير مضغوطة.
ملاحظة: هذه الخاصية جديدة في الإصدار 3.5 من بايثون.