كائنات الكتابة csvwriter‎‎ في بايثون

من موسوعة حسوب


كائنات الكتابة هي نسخ من الصنف DictWriter وتنشأ كذلك من استدعاء الدالة writer()‎.

خصائص كائنات الكتابة

تمتلك كائنات الكتابة الخصائص العامة التالية:

csvwriter.dialect

هذه الخاصية للقراءة فقط، وتتضمن وصفًا للهجة المستخدمة بواسطة كائن الكتابة.


توابع كائنات الكتابة

تمتلك كائنات الكتابة التوابع العامة التالية:

يجب أن يكون الصف row كائنًا قابلًا للتكرار من السلاسل النصية او الأرقام عند استخدام كائنات Writer وأن يكون قاموسًا يربط أسماء الحقول fieldnames بسلاسل نصية أو أرقام (عن طريق تمريرها عبر الدالة str()‎ في البداية) عند استخدام كائنات DictWriter. يجدر التنبيه إلى أنّ الأعداد المركّبة تُحاط بالأقواس، وقد يكون ذلك سببًا في حدوث بعض المشاكل في البرامج الأخرى التي تقرأ ملفات CSV (على فرض أنّها تستطيع التعامل مع الأعداد المركبة).

التابع csvwriter.writerow()‎

يكتب التابع السطر المعطى في كائن الملف الخاص بكائن القراءة، ويُنسّق السطر بالاعتماد على اللهجة المستخدمة.

ملاحظة: أضيف دعم كائنات التكرار بمختلف أنواعها في الإصدار 3.5 من بايثون.

التابع csvwriter.writerows()‎

يكتب التابع جميع العناصر في الصفوف المعطاة (كائن تكرار يتضمّن كائنات row) في كائن الملف الخاص بكائن الكتابة، وتنسق العناصر بالاعتماد على اللهجة المستخدمة.

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