عرض مصدر Python/marshal/dump

<noinclude>{{DISPLAYTITLE:الدالة <code>marshal.dump()‎</code> في بايثون}}</noinclude>

تكتب الدالة القيمة المعطاة في الملف المفتوح. 
== البنية العامة ==

<syntaxhighlight lang="python3">
marshal.dump(value, file[, version])
</syntaxhighlight>
‎
== المعاملات ==

=== <code>value</code> ===
القيمة المراد كتابتها إلى الملف. يجب أن تكون قيمة مدعومة من قبل الوحدة marshal.

=== <code>file</code> ===
الملف المراد كتابة القيمة فيه، ويجب أن يكون ملفًّا ثنائيًا قابلًا للكتابة.

=== <code>version</code> ===

يحدد هذا المعامل تنسيق البيانات الذي يجب على الدالة استخدامه. (راجع الثابت [[https://wiki.hsoub.com/Python/marshal#.D8.A7.D9.84.D8.AB.D8.A7.D8.A8.D8.AA_marshal.version|marshal.version]].

== القيمة المعادة ==

إن كانت القيمة غير مدعومة أو تضمّنت كائنًا غير مدعوم، تطلق اللغة الاستثناء ValueError، ولكن ستُكتب بيانات غير ذات قيمة إلى الملف المفتوح، ولن يُقرأ الكائن بطريقة صحيحة عند استخدام الدالة load()‎.

== أمثلة ==

يبين المثال التالي آلية عمل الدالة:

<syntaxhighlight lang="python3">

</syntaxhighlight>

== انظر أيضًا ==
* الدالة [[Python/marshal/dumps|marshal.dumps()‎]]: تقرأ الدالة قيمة واحدة من الملف المفتوح وتعيدها.
* الدالة [[Python/marshal/load|marshal.load()‎]]: تعيد الدالة كائن bytes الذي ستجري كتابته في ملفّ معين بواسطة الدالة dump(value, file)‎.
* الدالة [[Python/marshal/loads|marshal.loads()‎]]: تحوّل الدالة الكائنات الشبيهة بالبايتات إلى قيمة.

== مصادر ==
* [https://docs.python.org/3/library/marshal.html#marshal.dump صفحة Internal Python object serialization في توثيق بايثون الرسمي.]

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