الصنف csv.DictWriter()‎‎ في بايثون

تنشئ الدالة البانية لهذا الصنف كائنًا يعمل ككاتب عاديٍّ ولكنّه يربط القواميس بالأسطر الموجودة في ملف csv.

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

csv.DictWriter(f, fieldnames, restval='', extrasaction='raise', dialect='excel', *args, **kwds)

‎المعاملات

‎f

ملف csv الذي ستجري الكتابة فيه.

fieldnames

تسلسل من المفاتيح التي تحدّد ترتيب القيم في القاموس الذي سيمرّر إلى التابع writerow()‎ لكتابة الأسطر في الملف المعطى.

يجب الانتباه إلى أنّه وعلى عكس الصنف DictReader فإنّ المعامل fieldnames في الصنف DictWriter ليس اختياريًا.

restval

معامل اختياري، يحدّد القيمة التي ستُستخدم في حال وجود نقص في أسماء الحقول في القاموس الممرّر.

إن تضمن القاموس الممرّر إلى التابع 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.

مصادر

صفحة CSV File Reading and Writing في توثيق بايثون الرسمي.