التابع ConfigParser.read_dict()
في بايثون
< Python | ConfigParser
يحمّل التابع الإعدادات من أي كائن يوفّر تابعًا شبيهًا بالتابع items()
في كائنات dict
. تتضمّن المفاتيح أسماء الأقسام، أمّا القيم فعبارة عن قواميس تتضمّن المفاتيح والقيم التي تنطوي عليها الأقسام. إن كان القاموس المستخدم قادرًا على الاحتفاظ بترتيب العناصر، فستضاف الأقسام ومفاتيحها بحسب الترتيب. تُحوّل القيم إلى سلاسل نصية تلقائيًا.
يمكن استخدام هذا التابع لنسخ الحالة بين المحلّلات المختلفة.
البنية العامة
read_dict(dictionary, source='<dict>')
المعاملات
dictionary
القاموس الذي سيقرأ التابع منه الإعدادات.
source
معامل اختياري يحدد اسمًا خاصًّا بالسياق context-specific name للقاموس الممرّر. تُستخدم القيمة <dict>
في حال عدم استخدام هذا المعامل.
أمثلة
يبين المثال التالي طريقة عمل التابع:
>>> import configparser
>>> config = configparser.ConfigParser()
>>> cfgdict = {'bitbucket.org': {'User': 'hg'}, 'topsecret.server.com': {'Port': 50022, 'ForwardX11': 'no'}}
>>> config.read_dict(cfgdict)
>>> config.sections()
['bitbucket.org', 'topsecret.server.com']
>>> config.options('topsecret.server.com')
['port', 'forwardx11']
انظر أيضًا
- التابع
read()
: يحاول التابع قراءة وتفسير مكرِّر iterable من أسماء الملفات ويعيد قائمة بأسماء الملفات التي جرى تفسيرها بنجاح. - التابع
read_file()
: يقرأ التابع ويفسّر الإعدادات من المكرِّر المعطى. - التابع
read_string()
: يفسّر التابع الإعدادات من سلسلة نصية.