الفرق بين المراجعتين لصفحة: «Python/BZ2File»
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE:الصنف <code>bz2.BZ2File()</code> في بايثون}}</noinclude> تفتح الدالة البانية لهذا الصنف ملفًّا...' |
|||
| سطر 12: | سطر 12: | ||
=== <code>filename</code> === | === <code>filename</code> === | ||
إن كانت قيمة المعامل filename سلسلة نصية أو كائن | إن كانت قيمة المعامل <code>filename</code> [[Python/str|سلسلة نصية]] أو [[Python/bytes|كائن <code>bytes</code>]]، فإنّ الدالة تفتح الملفّ المسمّى مباشرة، وإلا فيجب أن تكون قيمة المعامل <code>filename</code> كائن ملفٍّ يُستخدم لقراءة البيانات المضغوطة أو كتابتها. | ||
=== <code>mode</code> === | === <code>mode</code> === | ||
يمكن أن يأخذ المعامل mode القيمة 'r' للقراءة (وهي القيمة الافتراضية) أو 'w' لإعادة الكتابة، أو 'x' للإنشاء | يمكن أن يأخذ المعامل <code>mode</code> القيمة <code>'r'</code> للقراءة (وهي القيمة الافتراضية) أو <code>'w'</code> لإعادة الكتابة، أو <code>'x'</code> للإنشاء الخاص exclusive creation، أو <code>'a'</code> لإلحاق البيانات. ويمكن تقديم هذه القيم بالصورة التالية <code>'rb'</code>، <code>'wb'</code>، <code>'xb'</code>، <code>'ab'</code>. | ||
إن كانت قيمة filename هي كائن ملف (بدلًا من اسم ملف) فإنّ استخدام القيمة 'w' لا يؤدي إلى | إن كانت قيمة <code>filename</code> هي كائن ملف (بدلًا من اسم ملف) فإنّ استخدام القيمة <code>'w'</code> لا يؤدي إلى تقطيع الملف من جانبيه truncate، بل تكون العملية مكافئة للنمط <code>'a'</code>. | ||
=== <code>buffering</code> === | === <code>buffering</code> === | ||
المعامل buffering مهمل، وتتجاهله الدالة عند أداء عملها. | المعامل <code>buffering</code> مهمل، وتتجاهله الدالة عند أداء عملها. | ||
=== <code>compresslevel</code> === | === <code>compresslevel</code> === | ||
إن كان النمط المستخدم هو 'w' أو 'a' فيمكن للمعامل compresslevel أن يكون رقمًا يتدرّج بين 1 و 9 ويحدّد مستوى عملية الضغط: الرقم 1 ينتج أقل مقدار من الضغط، والرقم 9 (القيمة الافتراضية) ينتج أعلى مقدار من الضغط. | إن كان النمط المستخدم هو <code>'w'</code> أو <code>'a'</code> فيمكن للمعامل <code>compresslevel</code> أن يكون رقمًا يتدرّج بين <code>1</code> و <code>9</code> ويحدّد مستوى عملية الضغط: الرقم <code>1</code> ينتج أقل مقدار من الضغط، والرقم <code>9</code> (القيمة الافتراضية) ينتج أعلى مقدار من الضغط. | ||
إن كان النمط المستخدم هو <code>'r'</code>، فيمكن للملف المعطى أن يكون ناتجًا عن ربط مجموعة من البيانات المضغوطة. | |||
== توابع الصنف <code>BZ2File</code> == | == توابع الصنف <code>BZ2File</code> == | ||
تقدّم كائنات BZ2File التوابع التالية: | تقدّم كائنات <code>BZ2File</code> التوابع التالية: | ||
=== التابع <code>peek()</code> === | === التابع <code>[[Python/BZ2File/peek|peek()]]</code> === | ||
يعيد التابع البيانات المخزنة في الذاكرة دون التحرّك في موقع الملف. | يعيد التابع البيانات المخزنة في الذاكرة دون التحرّك في موقع الملف. | ||
== مصادر == | == مصادر == | ||
* [https://docs.python.org/3/library/bz2.html#bz2. | * [https://docs.python.org/3/library/bz2.html#bz2.BZ2File صفحة Support for bzip2 compression في توثيق بايثون الرسمي.] | ||
[[تصنيف:Python]] | [[تصنيف:Python]] | ||
[[تصنيف:Python Modules]] | [[تصنيف:Python Modules]] | ||
مراجعة 19:58، 9 نوفمبر 2018
تفتح الدالة البانية لهذا الصنف ملفًّا مضغوطًا بخوارزمية bzip2 في النمط الثنائي.
البنية العامة
bz2.BZ2File(filename, mode='r', buffering=None, compresslevel=9)
المعاملات
filename
إن كانت قيمة المعامل filename سلسلة نصية أو كائن bytes، فإنّ الدالة تفتح الملفّ المسمّى مباشرة، وإلا فيجب أن تكون قيمة المعامل filename كائن ملفٍّ يُستخدم لقراءة البيانات المضغوطة أو كتابتها.
mode
يمكن أن يأخذ المعامل mode القيمة 'r' للقراءة (وهي القيمة الافتراضية) أو 'w' لإعادة الكتابة، أو 'x' للإنشاء الخاص exclusive creation، أو 'a' لإلحاق البيانات. ويمكن تقديم هذه القيم بالصورة التالية 'rb'، 'wb'، 'xb'، 'ab'.
إن كانت قيمة filename هي كائن ملف (بدلًا من اسم ملف) فإنّ استخدام القيمة 'w' لا يؤدي إلى تقطيع الملف من جانبيه truncate، بل تكون العملية مكافئة للنمط 'a'.
buffering
المعامل buffering مهمل، وتتجاهله الدالة عند أداء عملها.
compresslevel
إن كان النمط المستخدم هو 'w' أو 'a' فيمكن للمعامل compresslevel أن يكون رقمًا يتدرّج بين 1 و 9 ويحدّد مستوى عملية الضغط: الرقم 1 ينتج أقل مقدار من الضغط، والرقم 9 (القيمة الافتراضية) ينتج أعلى مقدار من الضغط.
إن كان النمط المستخدم هو 'r'، فيمكن للملف المعطى أن يكون ناتجًا عن ربط مجموعة من البيانات المضغوطة.
توابع الصنف BZ2File
تقدّم كائنات BZ2File التوابع التالية:
التابع peek()
يعيد التابع البيانات المخزنة في الذاكرة دون التحرّك في موقع الملف.