الفرق بين المراجعتين لصفحة: «Python/ConfigParser/read»
< Python | ConfigParser
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE:التابع <code>ConfigParser.read()</code> في بايثون}}</noinclude> يحاول التابع قراءة وتفسير مكرِّ...' |
لا ملخص تعديل |
||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE:التابع <code>ConfigParser.read()</code> في بايثون}}</noinclude> | <noinclude>{{DISPLAYTITLE:التابع <code>ConfigParser.read()</code> في بايثون}}</noinclude> | ||
يحاول التابع قراءة وتفسير مكرِّر iterable من أسماء الملفات | يحاول التابع قراءة وتفسير مكرِّر iterable من أسماء الملفات المعطاة. | ||
== البنية العامة == | == البنية العامة == | ||
| سطر 8: | سطر 8: | ||
</syntaxhighlight> | </syntaxhighlight> | ||
== المعاملات == | == المعاملات == | ||
=== <code>filenames</code> === | |||
[[Python/BZ2Compressor|سلسلة نصية]] أو كائن [[Python/bytes|bytes]] أو كائن شبيه بالملفات، ويعامل كاسم ملف واحد. إن لم يتمكن التابع من فتح الملف المحدد في المعامل <code>filenames</code> فإن التابع سيتجاهل ذلك الملف. صُمّم هذا التابع بطريقة تتيح للمسختدم تحديد مكرّر يتضمن المواقع المحتملة لملفات الإعدادات (مثل: المجلد الحالي، المجلد الرئيسي للمستخدم، وبعض مجلدات النظام) وسيقرأ التابع كل ملفات الإعدادات التي يعثر عليها في هذه المواقع. | |||
'''ملاحظات''': | '''ملاحظات''': | ||
* أضيف المعامل encoding في الإصدار 3.2 من بايثون. كانت جميع الملفات تُقرأ في الإصدارات السابقة باستخدام الترميز الافتراضي للدالة open(). | * أضيف المعامل <code>encoding</code> في الإصدار 3.2 من بايثون. كانت جميع الملفات تُقرأ في الإصدارات السابقة باستخدام الترميز الافتراضي للدالة <code>[[Python/open|open()]]</code>. | ||
* أصبح بالإمكان استخدام الكائنات الشبيهة بالمسارات كقيمة للمعامل filenames في الإصدار 3.6.1 من بايثون. | * أصبح بالإمكان استخدام الكائنات الشبيهة بالمسارات كقيمة للمعامل <code>filenames</code> في الإصدار 3.6.1 من بايثون. | ||
* أصبح بالإمكان استخدام كائن bytes كقيمة للمعامل filenames في الإصدار 3.7 من بايثون. | * أصبح بالإمكان استخدام كائن <code>[[Python/bytes|bytes]]</code> كقيمة للمعامل <code>filenames</code> في الإصدار 3.7 من بايثون. | ||
== القيمة المعادة == | == القيمة المعادة == | ||
يعيد التابع [[Python/list|قائمة]] بأسماء الملفات التي جرى تفسيرها بنجاح. | |||
== أمثلة == | == أمثلة == | ||
| سطر 32: | سطر 33: | ||
</syntaxhighlight> | </syntaxhighlight> | ||
إن لم يكن أي ملف من الملفات المعطاة موجودًا، فإن نسخة الصنف ConfigParser ستتضمّن مجموعة بيانات dataset فارغة. إن كان التطبيق بحاجة إلى تحميل بعض القيم من ملف الإعدادات عند تشغيل التطبيق لأول مرّة، فيجب تحميل الملف أو الملفات المطلوبة باستخدام التابع read_file() قبل استدعاء التابع read() على الملفات الأخرى: | إن لم يكن أي ملف من الملفات المعطاة موجودًا، فإن نسخة الصنف <code>[[Python/ConfigParser|ConfigParser]]</code> ستتضمّن مجموعة بيانات dataset فارغة. إن كان التطبيق بحاجة إلى تحميل بعض القيم من ملف الإعدادات عند تشغيل التطبيق لأول مرّة، فيجب تحميل الملف أو الملفات المطلوبة باستخدام التابع <code>[[Python/ConfigParser/read file|read_file()]]</code> قبل استدعاء التابع <code>read()</code> على الملفات الأخرى: | ||
<syntaxhighlight lang="python3"> | <syntaxhighlight lang="python3"> | ||
| سطر 46: | سطر 47: | ||
* التابع <code>[[Python/ConfigParser/read_file|read_file()]]</code>: يقرأ التابع ويفسّر الإعدادات من المكرِّر المعطى. | * التابع <code>[[Python/ConfigParser/read_file|read_file()]]</code>: يقرأ التابع ويفسّر الإعدادات من المكرِّر المعطى. | ||
* التابع <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 صفحة Configuration file parser في توثيق بايثون الرسمي.] | * [https://docs.python.org/3/library/configparser.html#configparser.ConfigParser.read صفحة Configuration file parser في توثيق بايثون الرسمي.] | ||
المراجعة الحالية بتاريخ 18:22، 30 نوفمبر 2018
يحاول التابع قراءة وتفسير مكرِّر iterable من أسماء الملفات المعطاة.
البنية العامة
read(filenames, encoding=None)
المعاملات
filenames
سلسلة نصية أو كائن bytes أو كائن شبيه بالملفات، ويعامل كاسم ملف واحد. إن لم يتمكن التابع من فتح الملف المحدد في المعامل filenames فإن التابع سيتجاهل ذلك الملف. صُمّم هذا التابع بطريقة تتيح للمسختدم تحديد مكرّر يتضمن المواقع المحتملة لملفات الإعدادات (مثل: المجلد الحالي، المجلد الرئيسي للمستخدم، وبعض مجلدات النظام) وسيقرأ التابع كل ملفات الإعدادات التي يعثر عليها في هذه المواقع.
ملاحظات:
- أضيف المعامل
encodingفي الإصدار 3.2 من بايثون. كانت جميع الملفات تُقرأ في الإصدارات السابقة باستخدام الترميز الافتراضي للدالةopen(). - أصبح بالإمكان استخدام الكائنات الشبيهة بالمسارات كقيمة للمعامل
filenamesفي الإصدار 3.6.1 من بايثون. - أصبح بالإمكان استخدام كائن
bytesكقيمة للمعاملfilenamesفي الإصدار 3.7 من بايثون.
القيمة المعادة
يعيد التابع قائمة بأسماء الملفات التي جرى تفسيرها بنجاح.
أمثلة
يبين المثال التالي طريقة عمل التابع:
>>> import configparser
>>> config = configparser.ConfigParser()
>>> config.read('config.cfg')
['config.cfg']
إن لم يكن أي ملف من الملفات المعطاة موجودًا، فإن نسخة الصنف ConfigParser ستتضمّن مجموعة بيانات dataset فارغة. إن كان التطبيق بحاجة إلى تحميل بعض القيم من ملف الإعدادات عند تشغيل التطبيق لأول مرّة، فيجب تحميل الملف أو الملفات المطلوبة باستخدام التابع read_file() قبل استدعاء التابع read() على الملفات الأخرى:
import configparser, os
config = configparser.ConfigParser()
config.read_file(open('defaults.cfg'))
config.read(['site.cfg', os.path.expanduser('~/.myapp.cfg')],
encoding='cp1250')
انظر أيضًا
- التابع
read_file(): يقرأ التابع ويفسّر الإعدادات من المكرِّر المعطى. - التابع
read_string(): يفسّر التابع الإعدادات من سلسلة نصية. - التابع
read_dict(): يحمّل التابع الإعدادات من أي كائن يوفّر تابعًا شبيهًا بالتابعitems() في كائناتdict.