الفرق بين المراجعتين لصفحة: «Python/ConfigParser/read file»
< Python | ConfigParser
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE:التابع <code>ConfigParser.read_file()</code> في بايثون}}</noinclude> يقرأ التابع ويفسّر الإعدادات...' |
لا ملخص تعديل |
||
| سطر 7: | سطر 7: | ||
read_file(f, source=None) | read_file(f, source=None) | ||
</syntaxhighlight> | </syntaxhighlight> | ||
== | == المعاملات == | ||
=== f === | |||
=== <code>f</code> === | |||
مكرّر ينتج سلاسل نصية بترميز Unicode (مثل ملفات مفتوحة في الوضع النصي text mode). | مكرّر ينتج سلاسل نصية بترميز Unicode (مثل ملفات مفتوحة في الوضع النصي text mode). | ||
=== source === | === <code>source</code> === | ||
معامل اختياري يحدد اسم الملف الذي تجري قرائته. إن لم يمرّر هذا المعامل وكان للمعامل f خاصية name فستُستخدم كقيمة للمعامل source. القيمة الافتراضية لهذا المعامل هي '<???>'. | معامل اختياري يحدد اسم الملف الذي تجري قرائته. إن لم يمرّر هذا المعامل وكان للمعامل <code>f</code> خاصية <code>name</code> فستُستخدم كقيمة للمعامل <code>source</code>. القيمة الافتراضية لهذا المعامل هي <code>'<???>'</code>. | ||
'''ملاحظة''': حلّ هذا التابع محلّ التابع readfp() في الإصدار 3.2 من بايثون. | '''ملاحظة''': حلّ هذا التابع محلّ التابع <code>[[Python/ConfigParser/readfp|readfp()]]</code> في الإصدار 3.2 من بايثون. | ||
== أمثلة == | == أمثلة == | ||
| سطر 31: | سطر 32: | ||
* التابع <code>[[Python/ConfigParser/read|read()]]</code>: يحاول التابع قراءة وتفسير مكرِّر iterable من أسماء الملفات ويعيد قائمة بأسماء الملفات التي جرى تفسيرها بنجاح. | * التابع <code>[[Python/ConfigParser/read|read()]]</code>: يحاول التابع قراءة وتفسير مكرِّر iterable من أسماء الملفات ويعيد قائمة بأسماء الملفات التي جرى تفسيرها بنجاح. | ||
* التابع <code>[[Python/ConfigParser/read_string|read_string()]]</code>: يفسّر التابع الإعدادات من سلسلة نصية. | * التابع <code>[[Python/ConfigParser/read_string|read_string()]]</code>: يفسّر التابع الإعدادات من سلسلة نصية. | ||
* التابع <code>[[Python/ConfigParser/read_dict|read_dict()]]</code>: يحمّل التابع الإعدادات من أي كائن يوفّر تابعًا شبيهًا بالتابع items() في كائنات dict. | |||
*التابع <code>[[Python/ConfigParser/read_dict|read_dict()]]</code>: يحمّل التابع الإعدادات من أي كائن يوفّر تابعًا شبيهًا بالتابع <code>[[Python/dict/items|items()]]</code> في كائنات <code>[[Python/dict|dict]]</code>. | |||
== مصادر == | == مصادر == | ||
* [https://docs.python.org/3/library/configparser.html#configparser.ConfigParser.read_file صفحة Configuration file parser في توثيق بايثون الرسمي.] | * [https://docs.python.org/3/library/configparser.html#configparser.ConfigParser.read_file صفحة Configuration file parser في توثيق بايثون الرسمي.] | ||
المراجعة الحالية بتاريخ 18:30، 30 نوفمبر 2018
يقرأ التابع ويفسّر الإعدادات من المكرِّر iterable المعطى.
البنية العامة
read_file(f, source=None)
المعاملات
f
مكرّر ينتج سلاسل نصية بترميز Unicode (مثل ملفات مفتوحة في الوضع النصي text mode).
source
معامل اختياري يحدد اسم الملف الذي تجري قرائته. إن لم يمرّر هذا المعامل وكان للمعامل f خاصية name فستُستخدم كقيمة للمعامل source. القيمة الافتراضية لهذا المعامل هي '<???>'.
ملاحظة: حلّ هذا التابع محلّ التابع readfp() في الإصدار 3.2 من بايثون.
أمثلة
يبين المثال التالي طريقة عمل التابع:
import configparser, os
config = configparser.ConfigParser()
config.read_file(open('defaults.cfg'))
انظر أيضًا
- التابع
read(): يحاول التابع قراءة وتفسير مكرِّر iterable من أسماء الملفات ويعيد قائمة بأسماء الملفات التي جرى تفسيرها بنجاح. - التابع
read_string(): يفسّر التابع الإعدادات من سلسلة نصية.
- التابع
read_dict(): يحمّل التابع الإعدادات من أي كائن يوفّر تابعًا شبيهًا بالتابعitems() في كائناتdict.