عرض مصدر Python/ConfigParser/get

<noinclude>{{DISPLAYTITLE:التابع <code>ConfigParser.get()‎‎</code> في بايثون}}</noinclude>

يجلب التابع الخيار المحدّد من القسم المعطى.

== البنية العامة ==

<syntaxhighlight lang="python3">
get(section, option, *, raw=False, vars=None[, fallback])
</syntaxhighlight>

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

=== ‎<code>section</code> ===
اسم القسم الذي سيجلب التابع الخيار منه.

=== <code>option</code> ===
قيمة الخيار المراد جلبه. 

يبحث التابع عن قيمة المعامل <code>option</code> في <code>vars</code> (إن كان متوفّرًا) ثم في <code>section</code> ثم في <code>DEFAULTSECT</code>. 

=== <code>raw</code> ===
يوسّع التابع جميع عمليات الاستيفاء التي تستخدم الرمز <code>'%'</code> في القيمة المعادة إلا إذا كان إذا أخذ المعامل <code>raw</code> القيمة <code>True</code>.

=== <code>vars</code> ===
معامل اختياري، يجب أن تكون قيمته قاموسًا.

=== <code>fallback</code> ===
في حال عدم عثور التابع على المفتاح المطلوب فإنّه يستخدم قيمة المعامل <code>fallback</code> كقيمة تراجعية في حال توفّرها. يمكن تقديم القيمة <code>None</code> كقيمة تراجعية.

'''ملاحظة:''' تحوّلت المعاملات <code>raw</code> و <code>vars</code> و <code>fallback</code> إلى معاملات مفتاحية وذلك لمنع المستخدم من محاول استخدام المعامل الثالث كقيمة تراجعية للمعامل <code>fallback</code> (خاصة عند استعمال بروتوكول الربط mapping protocol).
== القيمة المعادة ==
يعيد التابع القيمة التي يجلبها من ملف الإعدادات بعد تحويلها إلى [[Python/str|سلسلة نصية]].

== أمثلة ==

يبين المثال التالي طريقة عمل التابع:

<syntaxhighlight lang="python3">
>>> import configparser
>>> config = configparser.ConfigParser()
>>> config.read('config.cfg')
['config.cfg']
>>> config.get('topsecret.server.com', 'Port')
'50022'
>>> config.get('topsecret.server.com', 'ForwardX11')
'no'

</syntaxhighlight>

== انظر أيضًا ==
* التابع <code>[[Python/ConfigParser/getint|getint()‎]]</code>: تابع مساعد وظيفته تحويل الخيار المعطى في القسم المحدّد إلى [[PHP|عدد صحيح]].
* التابع <code>[[Python/ConfigParser/getfloat|getfloat()‎]]</code>: تابع مساعد وظيفته تحويل الخيار المعطى في القسم المحدّد إلى عدد عشري ذي فاصلة عائمة [[PHP|<code>float</code>]].
* التابع <code>[[Python/ConfigParser/getboolean|getboolean()‎]]</code>: تابع مساعد وظيفته تحويل الخيار المعطى في القسم المحدّد إلى [[Python/boolean|قيمة منطقية]] (بوليانية).
== مصادر ==
* [https://docs.python.org/3/library/configparser.html#configparser.ConfigParser.get صفحة Configuration file parser في توثيق بايثون الرسمي.]

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