الفرق بين المراجعتين لصفحة: «Python/marshal/dump»
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE:الدالة <code>marshal.dump()</code> في بايثون}}</noinclude> تكتب الدالة القيمة المعطاة في الملف...' |
|||
| سطر 7: | سطر 7: | ||
marshal.dump(value, file[, version]) | marshal.dump(value, file[, version]) | ||
</syntaxhighlight> | </syntaxhighlight> | ||
== | == المعاملات == | ||
=== <code>value</code> === | === <code>value</code> === | ||
القيمة المراد كتابتها إلى الملف. يجب أن تكون قيمة مدعومة من قبل الوحدة marshal. | القيمة المراد كتابتها إلى الملف. يجب أن تكون قيمة مدعومة من قبل الوحدة <code>marshal</code>. | ||
=== <code>file</code> === | === <code>file</code> === | ||
| سطر 18: | سطر 18: | ||
=== <code>version</code> === | === <code>version</code> === | ||
يحدد هذا المعامل تنسيق البيانات الذي يجب على الدالة استخدامه. (راجع الثابت [[ | يحدد هذا المعامل تنسيق البيانات الذي يجب على الدالة استخدامه. (راجع الثابت <code>[[Python/marshal#.D8.A7.D9.84.D8.AB.D8.A7.D8.A8.D8.AA marshal.version|marshal.version]]</code>). | ||
== القيمة المعادة == | == القيمة المعادة == | ||
إن كانت القيمة غير مدعومة أو تضمّنت كائنًا غير مدعوم، تطلق اللغة الاستثناء | إن كانت القيمة غير مدعومة أو تضمّنت كائنًا غير مدعوم، تطلق اللغة الاستثناء <code>ValueError</code>، ولكن ستُكتب بيانات غير ذات قيمة إلى الملف المفتوح، ولن يُقرأ الكائن بطريقة صحيحة عند استخدام الدالة <code>[[Python/marshal/load|load()]]</code>. | ||
== أمثلة == | == أمثلة == | ||
| سطر 29: | سطر 29: | ||
<syntaxhighlight lang="python3"> | <syntaxhighlight lang="python3"> | ||
>>> import marshal | |||
>>> f = open('file1', 'bw') | |||
>>> marshal.dump('Hello World', f) | |||
13 | |||
</syntaxhighlight> | </syntaxhighlight> | ||
== انظر أيضًا == | == انظر أيضًا == | ||
* الدالة [[Python/marshal/dumps|marshal.dumps()]]: تقرأ الدالة قيمة واحدة من الملف المفتوح وتعيدها. | * الدالة [[Python/marshal/dumps|<code>marshal.dumps()</code>]]: تقرأ الدالة قيمة واحدة من الملف المفتوح وتعيدها. | ||
* الدالة [[Python/marshal/load|marshal.load()]]: تعيد الدالة كائن bytes الذي ستجري كتابته في ملفّ معين بواسطة الدالة dump(value, file). | * الدالة [[Python/marshal/load|<code>marshal.load()</code>]]: تعيد الدالة كائن <code>bytes</code> الذي ستجري كتابته في ملفّ معين بواسطة الدالة <code>dump(value, file)</code>. | ||
* الدالة [[Python/marshal/loads|marshal.loads()]]: تحوّل الدالة الكائنات الشبيهة بالبايتات إلى قيمة. | * الدالة [[Python/marshal/loads|<code>marshal.loads()</code>]]: تحوّل الدالة الكائنات الشبيهة بالبايتات إلى قيمة. | ||
== مصادر == | == مصادر == | ||
المراجعة الحالية بتاريخ 07:19، 16 سبتمبر 2018
تكتب الدالة القيمة المعطاة في الملف المفتوح.
البنية العامة
marshal.dump(value, file[, version])
المعاملات
value
القيمة المراد كتابتها إلى الملف. يجب أن تكون قيمة مدعومة من قبل الوحدة marshal.
file
الملف المراد كتابة القيمة فيه، ويجب أن يكون ملفًّا ثنائيًا قابلًا للكتابة.
version
يحدد هذا المعامل تنسيق البيانات الذي يجب على الدالة استخدامه. (راجع الثابت marshal.version).
القيمة المعادة
إن كانت القيمة غير مدعومة أو تضمّنت كائنًا غير مدعوم، تطلق اللغة الاستثناء ValueError، ولكن ستُكتب بيانات غير ذات قيمة إلى الملف المفتوح، ولن يُقرأ الكائن بطريقة صحيحة عند استخدام الدالة load().
أمثلة
يبين المثال التالي آلية عمل الدالة:
>>> import marshal
>>> f = open('file1', 'bw')
>>> marshal.dump('Hello World', f)
13
انظر أيضًا
- الدالة
marshal.dumps(): تقرأ الدالة قيمة واحدة من الملف المفتوح وتعيدها. - الدالة
marshal.load(): تعيد الدالة كائنbytesالذي ستجري كتابته في ملفّ معين بواسطة الدالةdump(value, file). - الدالة
marshal.loads(): تحوّل الدالة الكائنات الشبيهة بالبايتات إلى قيمة.