عرض مصدر Python/csv/reader

<noinclude>{{DISPLAYTITLE:الدالة <code>csv.reader()‎‎</code> في بايثون}}</noinclude>
تعيد الدالة كائن قراءة مهمّته هي المرور على جميع الأسطر في ملف csv المعطى.
== البنية العامة ==

<syntaxhighlight lang="python3">
csv.reader(csvfile, dialect='excel', **fmtparams)
</syntaxhighlight>

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

=== <code>csvfile</code> ===
ملف csv المراد قراءة محتوياته، ويمكن أن تكون قيمة هذا المعامل أيّ كائن يدعم بروتوكول المكرِّر iterator protocol ويعيد سلسلة نصية في كلّ مرة يجري فيها استدعاء التابع ‎__next__()‎، وعادة ما تكون كائنات الملفات وكائنات القوائم ملائمة لهذا الغرض.

إن كانت قيمة هذا المعامل كائن ملف، فيجب أن يكون مفتوحًا مع المعامل <code><nowiki>''</nowiki>newline=''‎''</code>''. ''

'''ملاحظة''': إن لم تحدد القيمة <code><nowiki>''</nowiki>newline=''‎''</code> لن تُفسّر الأسطر الجديدة في الحقول المحاطة بعلامات اقتباس بطريقة صحيحة، وسيضاف رمز ‎<code>\r</code> إضافي إلى الأسطر المنتهية بالرمز <code>‎\r\n</code> في المنصّات التي تستخدم الرمز الأخير في نهايات الأسطر. يُنصح بتحديد القيمة <code><nowiki>''</nowiki>newline=''‎''</code> دائمًا إذ تمتلك وحدة <code>csv</code> طريقتها الخاصة في التعامل مع نهايات الأسطر بمختلف أنواعها.

=== <code>dialect</code> ===
معامل اختياري، يمكن استخدامه لتعريف مجموعة من المعاملات الخاصة بلهجة CSV ‏(CSV dialect)‏ معيّنة. يمكن أن تكون قيمة هذا المعامل نسخة من صنف متفرّع عن الصنف <code>[[Python/Dialect|Dialect]]</code> أو واحدة من السلاسل النصية التي تعيدها الدالة <code>[[Python/csv/list dialects|list_dialects()‎]]</code>. 

=== <code>fmtparams</code> ===
معامل مفتاحي اختياري، يمكن تحديد قيمته لإعادة تعريف معاملات التنسيق في اللهجة المستخدمة. راجع قسم [[Python/csv#.D8.A7.D9.84.D9.84.D9.87.D8.AC.D8.A7.D8.AA .D9.88.D9.85.D8.B9.D8.A7.D9.85.D9.84.D8.A7.D8.AA .D8.A7.D9.84.D8.AA.D9.86.D8.B3.D9.8A.D9.82|اللهجات ومعاملات التنسيق]] للاطلاع على المزيد من المعلومات.

== القيمة المعادة ==
يعاد كلّ سطر تقرأه الدالة من ملف csv كقائمة من السلاسل النصية، ولا تُجرى أي تحويلات تلقائية للبيانات إلا إذا استخدم خيار التنسيق <code>QUOTE_NONNUMERIC</code> (في هذه الحالة تحوّل القيم غير المحاطة بعلامات اقتباس إلى أعداد ذات فاصلة عشرية).

== أمثلة ==

يبين المثال التالي طريقة استخدام الدالة:

<syntaxhighlight lang="python3">
>>> import csv
>>> with open('eggs.csv', newline='') as csvfile:
...     spamreader = csv.reader(csvfile, delimiter=' ', quotechar='|')
...     for row in spamreader:
...         print(', '.join(row))
Spam, Spam, Spam, Spam, Spam, Baked Beans
Spam, Lovely Spam, Wonderful Spam

</syntaxhighlight>

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

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