الفرق بين المراجعتين ل"Python/DictWriter"
(أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE:الصنف <code>csv.DictWriter()</code> في بايثون}}</noinclude> تنشئ الدالة البانية لهذا الصنف كائ...') |
|||
| سطر 14: | سطر 14: | ||
=== <code>fieldnames</code> === | === <code>fieldnames</code> === | ||
| − | تسلسل من المفاتيح التي تحدّد ترتيب القيم في القاموس الذي سيمرّر إلى التابع writerow() لكتابة الأسطر في الملف المعطى. | + | تسلسل من المفاتيح التي تحدّد ترتيب القيم في القاموس الذي سيمرّر إلى التابع <code>writerow()</code> لكتابة الأسطر في الملف المعطى. |
| − | يجب الانتباه إلى أنّه وعلى عكس الصنف DictReader فإنّ المعامل fieldnames في الصنف DictWriter ليس اختياريًا. | + | يجب الانتباه إلى أنّه وعلى عكس الصنف <code>[[Python/DictReader|DictReader]]</code> فإنّ المعامل <code>fieldnames</code> في الصنف <code>DictWriter</code> ليس اختياريًا. |
=== <code>restval</code> === | === <code>restval</code> === | ||
معامل اختياري، يحدّد القيمة التي ستُستخدم في حال وجود نقص في أسماء الحقول في القاموس الممرّر. | معامل اختياري، يحدّد القيمة التي ستُستخدم في حال وجود نقص في أسماء الحقول في القاموس الممرّر. | ||
| − | إن تضمن القاموس الممرّر إلى التابع writerow() مفتاحًا غير موجود في المعامل | + | === <code>extrasaction</code> === |
| + | إن تضمن القاموس الممرّر إلى التابع <code>writerow()</code> مفتاحًا غير موجود في المعامل <code>fieldnames</code>، فإنّ المعامل <code>extrasaction</code> يحدّد الإجراء الذي يجب اتخاذه في هذه الحالة. فإن أخذ هذا المعامل القيمة <code>'raise'</code> (وهي القيمة الافتراضية) يطلق التابع الاستثناء <code>ValueError</code>، وإن أخذ المعامل القيمة <code>'ignore'</code> سيتجاهل التابع القيم الإضافية في القاموس. | ||
| − | تمرّر بقية المعاملات الاختيارية أو المفتاحية إلى نسخة [[Python/csv/ | + | تمرّر بقية المعاملات الاختيارية أو المفتاحية إلى نسخة [[Python/csv/writer|كائن الكتابة]] الضمني. |
== أمثلة == | == أمثلة == | ||
مراجعة 21:06، 26 نوفمبر 2018
تنشئ الدالة البانية لهذا الصنف كائنًا يعمل ككاتب عاديٍّ ولكنّه يربط القواميس بالأسطر الموجودة في ملف csv.
البنية العامة
csv.DictWriter(f, fieldnames, restval='', extrasaction='raise', dialect='excel', *args, **kwds)
المعاملات
f
ملف csv الذي ستجري الكتابة فيه.
fieldnames
تسلسل من المفاتيح التي تحدّد ترتيب القيم في القاموس الذي سيمرّر إلى التابع writerow() لكتابة الأسطر في الملف المعطى.
يجب الانتباه إلى أنّه وعلى عكس الصنف DictReader فإنّ المعامل fieldnames في الصنف DictWriter ليس اختياريًا.
restval
معامل اختياري، يحدّد القيمة التي ستُستخدم في حال وجود نقص في أسماء الحقول في القاموس الممرّر.
extrasaction
إن تضمن القاموس الممرّر إلى التابع writerow() مفتاحًا غير موجود في المعامل fieldnames، فإنّ المعامل extrasaction يحدّد الإجراء الذي يجب اتخاذه في هذه الحالة. فإن أخذ هذا المعامل القيمة 'raise' (وهي القيمة الافتراضية) يطلق التابع الاستثناء ValueError، وإن أخذ المعامل القيمة 'ignore' سيتجاهل التابع القيم الإضافية في القاموس.
تمرّر بقية المعاملات الاختيارية أو المفتاحية إلى نسخة كائن الكتابة الضمني.
أمثلة
يبين المثال التالي طريقة الاستفادة من كائنات الكتابة:
import csv
with open('names.csv', 'w', newline='') as csvfile:
fieldnames = ['first_name', 'last_name']
writer = csv.DictWriter(csvfile, fieldnames=fieldnames)
writer.writeheader()
writer.writerow({'first_name': 'Baked', 'last_name': 'Beans'})
writer.writerow({'first_name': 'Lovely', 'last_name': 'Spam'})
writer.writerow({'first_name': 'Wonderful', 'last_name': 'Spam'})
انظر أيضًا
- الدالة
csv.writer(): تعيد الدالة كائن قراءة مهمّته هي المرور على جميع الأسطر في ملف csv المعطى. - الصنف
DictReader.