عرض مصدر Python/Unpickler

<noinclude>{{DISPLAYTITLE:الصنف <code>pickle.Unpickler()‎</code> في بايثون}}</noinclude>

يستخدم هذا الصنف ملفًّا ثنائيًا يقرأ منه تدفق البيانات المسلسلة.

يجري الكشف عن رقم البروتوكول المستخدم تلقائيًا؛ لذا لا حاجة لأي معامل لتحديده.

== البنية العامة ==

<syntaxhighlight lang="python3">
class pickle.Unpickler(file, *, fix_imports=True, encoding="ASCII", errors="strict")
</syntaxhighlight>
‎
== المعاملات ==

=== <code>file</code> ===

يجب أن يمتلك المعامل file تابعين، الأول هو تابع read()‎ والذي يأخذ معاملًا عدديًا، وتابع readline()‎ والذي لا يحتاج إلى أيّ معاملات. يجب أن يعيد كلا المعاملين كائنات bytes، ولهذا يمكن أن يكون file كائن ملف مخزّنًا على القرص الصلب ومفتوحًا للقراءة الثنائية، أو كائن io.BytesIO أو أي كائن آخر يطابق هذه الشروط.

=== <code>fix_imports</code> ===

إن أخذ هذا المعامل القيمة <code>True</code> وكانت قيمة المعامل <code>protocol</code> أقل من <code>3</code>، فإنّ وحدة <code>[[Python/pickle|pickle]]</code> ستحاول ربط الأسماء الجديدة في الإصدار 3 من بايثون بأسماء الوحدات القديمة المستخدمة في الإصدار 2 من بايثون، بحيث يكون تدفق البيانات مقروءًا في الإصدار 2 من بايثون.

=== المعاملان <code>encoding</code> و <code>errors</code>===

يُعلم المعاملان encoding و errors وحدة pickle عن كيفية فك ترميز نسخ السلاسل النصية ‎8-bit والمُسَلسَلة في الإصدار الثاني من بايثون. يأخذ هذا المعاملان القيمتين الافتراضيتين 'ASCII' و 'strict' على التوالي. ويمكن أن يأخذ المعامل encoding القيمة 'bytes' وذلك لقراءة نسخ السلاسل النصية ‎8-bit ككائنات bytes.

تستخدم المعاملات الاختيارية fix_imports، encoding و errors في التحكم بدعم التوافق لتدفق السلسلة الناتج من الإصدار الثاني من بايثون. 

== توابع الصنف <code>Pickler</code> ==

=== التابع <code>[[Python/Pickler/load|load()‎]]</code> ===
يقرأ التابع تمثيل كائن مسلسل من كائن الملف المفتوح في الدالة البانية للصنف، ويعيد هيكل الكائن المعاد بناؤه والموصوف في هذا الملف.

=== التابع <code>[[Python/Pickler/persistent_load|persistent_load()]]‎</code> ===
يطلق هذا التابع افتراضيًا الاستثناء UnpicklingError.

=== التابع <code>[[Python/Pickler/find_class|find_class()]]‎</code> ===
يستورد التابع الوحدة المعطاة إذا اقتضت الحاجة ويعيد الكائن الذي يحمل الاسم المحدّد.

== انظر أيضًا ==

* [[Python/Pickler|الصنف <code>Pickler</code>]] : يستخدم هذا الصنف ملفًّا يكتب فيه تدفق البيانات المسلسلة.

== مصادر ==

* [https://docs.python.org/3/library/pickle.html#pickle.Unpickler صفحة DB-API 2.0 interface for SQLite databases في توثيق بايثون الرسمي.]

[[تصنيف:Python]]
[[تصنيف:Python Modules]]