الدالة marshal.dump() في بايثون
تكتب الدالة القيمة المعطاة في الملف المفتوح.
البنية العامة
marshal.dump(value, file[, version])
المعاملات
value
القيمة المراد كتابتها إلى الملف. يجب أن تكون قيمة مدعومة من قبل الوحدة marshal.
file
الملف المراد كتابة القيمة فيه، ويجب أن يكون ملفًّا ثنائيًا قابلًا للكتابة.
version
يحدد هذا المعامل تنسيق البيانات الذي يجب على الدالة استخدامه. (راجع الثابت [[1]].
القيمة المعادة
إن كانت القيمة غير مدعومة أو تضمّنت كائنًا غير مدعوم، تطلق اللغة الاستثناء ValueError، ولكن ستُكتب بيانات غير ذات قيمة إلى الملف المفتوح، ولن يُقرأ الكائن بطريقة صحيحة عند استخدام الدالة load().
أمثلة
يبين المثال التالي آلية عمل الدالة:
انظر أيضًا
- الدالة marshal.dumps(): تقرأ الدالة قيمة واحدة من الملف المفتوح وتعيدها.
- الدالة marshal.load(): تعيد الدالة كائن bytes الذي ستجري كتابته في ملفّ معين بواسطة الدالة dump(value, file).
- الدالة marshal.loads(): تحوّل الدالة الكائنات الشبيهة بالبايتات إلى قيمة.