الفرق بين المراجعتين لصفحة: «Python/ConfigParser/read dict»
< Python | ConfigParser
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE:التابع <code>ConfigParser.read_dict()</code> في بايثون}}</noinclude> يحمّل التابع الإعدادات من أي...' |
لا ملخص تعديل |
||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE:التابع <code>ConfigParser.read_dict()</code> في بايثون}}</noinclude> | <noinclude>{{DISPLAYTITLE:التابع <code>ConfigParser.read_dict()</code> في بايثون}}</noinclude> | ||
يحمّل التابع الإعدادات من أي كائن يوفّر تابعًا شبيهًا بالتابع items() في كائنات dict. تتضمّن المفاتيح أسماء الأقسام، أمّا القيم فعبارة عن قواميس تتضمّن المفاتيح والقيم التي تنطوي عليها الأقسام. إن كان القاموس المستخدم قادرًا على الاحتفاظ بترتيب العناصر، فستضاف الأقسام ومفاتيحها بحسب الترتيب. تُحوّل القيم إلى سلاسل نصية تلقائيًا. | يحمّل التابع الإعدادات من أي كائن يوفّر تابعًا شبيهًا بالتابع [[Python/dict/items|<code>items()</code>]] في كائنات <code>[[Python/dict|dict]]</code>. تتضمّن المفاتيح أسماء الأقسام، أمّا القيم فعبارة عن [[Python/dict|قواميس]] تتضمّن المفاتيح والقيم التي تنطوي عليها الأقسام. إن كان [[Python/dict|القاموس]] المستخدم قادرًا على الاحتفاظ بترتيب العناصر، فستضاف الأقسام ومفاتيحها بحسب الترتيب. تُحوّل القيم إلى [[Python/str|سلاسل نصية]] تلقائيًا. | ||
يمكن استخدام هذا التابع لنسخ الحالة بين المحلّلات المختلفة. | يمكن استخدام هذا التابع لنسخ الحالة بين المحلّلات المختلفة. | ||
| سطر 10: | سطر 10: | ||
read_dict(dictionary, source='<dict>') | read_dict(dictionary, source='<dict>') | ||
</syntaxhighlight> | </syntaxhighlight> | ||
== | == المعاملات == | ||
=== dictionary === | |||
القاموس الذي سيقرأ التابع منه الإعدادات. | === <code>dictionary</code> === | ||
=== source === | [[Python/dict|القاموس]] الذي سيقرأ التابع منه الإعدادات. | ||
معامل اختياري يحدد اسمًا خاصًّا بالسياق context-specific name للقاموس الممرّر. تُستخدم القيمة <dict> في حال عدم استخدام هذا المعامل. | === <code>source</code> === | ||
معامل اختياري يحدد اسمًا خاصًّا بالسياق context-specific name [[Python/dict|للقاموس]] الممرّر. تُستخدم القيمة <code><dict></code> في حال عدم استخدام هذا المعامل. | |||
== أمثلة == | == أمثلة == | ||
المراجعة الحالية بتاريخ 18:43، 30 نوفمبر 2018
يحمّل التابع الإعدادات من أي كائن يوفّر تابعًا شبيهًا بالتابع 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(): يفسّر التابع الإعدادات من سلسلة نصية.