عرض مصدر Python/DictReader

<noinclude>{{DISPLAYTITLE:الصنف <code>csv.DictReader()‎‎</code> في بايثون}}</noinclude>
تنشئ الدالة البانية لهذا الصنف كائنًا يعمل كقارئ عادي ولكنّه يربط المعلومات في كل سطر بقاموس مرتّب <code>[[Python/OrderedDict|OrderedDict]]</code> تحدّد مفاتيحه بواسطة المعامل الاختياري <code>fieldnames</code>.

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

<syntaxhighlight lang="python3">
csv.DictReader(f, fieldnames=None, restkey=None, restval=None, dialect='excel', *args, **kwds)
</syntaxhighlight>

== ‎المعاملات ==

=== <code>‎f</code> ===
ملف csv المراد قرائته.

=== <code>fieldnames</code> ===
معامل اختياري، وهو عبارة عن تسلسل. إن لم يُستخدم هذا المعامل فإنّ القيم الموجودة في السطر الأول من الملف المفتوح ستُستخدم كأسماء للحقول. وبصرف النظر عن طريقة تحديد أسماء الحقول فإنّ [[Python/OrderedDict|القاموس المرتّب]] سيحافظ دائمًا على ترتيبها الأصلي.

=== <code>restkey</code> ===
إن تضمّن سطرٌ حقولًا أكثر من أسماء الحقول، توضع البيانات المتبقّية في قائمة وتُخزّن تحت حقل يحمل الاسم المحدّد بواسطة المعامل <code>restkey</code> (والذي يأخذ القيمة الافتراضية <code>None</code>).

إن امتلك سطر غير فارغ حقولًا أقلّ من اسماء الحقول، توضع القيمة <code>None</code> محلّ القيم المفقودة.

تمرّر بقية المعاملات الاختيارية أو المفتاحية إلى نسخة [[Python/csv/reader|كائن القراءة]] الضمني.

ملاحظة: أصبحت الأسطر المعادة من نوع [[Python/OrderedDict|OrderedDict]] في الإصدار 3.6 من بايثون.

== أمثلة ==

يبين المثال التالي طريقة الاستفادة من كائنات القراءة:

<syntaxhighlight lang="python3">
>>> import csv
>>> with open('names.csv', newline='') as csvfile:
...     reader = csv.DictReader(csvfile)
...     for row in reader:
...         print(row['first_name'], row['last_name'])
...
Eric Idle
John Cleese

>>> print(row)
OrderedDict([('first_name', 'John'), ('last_name', 'Cleese')])

</syntaxhighlight>

== انظر أيضًا ==
* الدالة <code>[[Python/csv/reader|csv.reader()‎]]</code>: تعيد الدالة كائن قراءة مهمّته هي المرور على جميع الأسطر في ملف csv المعطى.
* الصنف <code>[[Python/DictWriter|DictWriter]]</code>.
== مصادر ==
[https://docs.python.org/3/library/csv.html#csv.DictReader صفحة CSV File Reading and Writing في توثيق بايثون الرسمي.]

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