الفرق بين المراجعتين ل"Python/RawConfigParser/add section"
< Python | RawConfigParser
اذهب إلى التنقل
اذهب إلى البحث
(أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE:التابع <code>RawConfigParser.add_section()</code> في بايثون}}</noinclude> يضيف التابع قسمًا يحمل الا...') |
|||
| سطر 8: | سطر 8: | ||
add_section(section) | add_section(section) | ||
</syntaxhighlight> | </syntaxhighlight> | ||
| − | |||
== المعاملات == | == المعاملات == | ||
| − | |||
| − | |||
| + | === <code>section</code> === | ||
اسم القسم المراد إضافته إلى ملف الإعدادات. | اسم القسم المراد إضافته إلى ملف الإعدادات. | ||
== القيمة المعادة == | == القيمة المعادة == | ||
| − | إن كان هناك صنف يحمل الاسم ذاته فإنّ التابع يطلق الاستثناء DuplicateSectionError. وإن كان الاسم المعطى هو اسم قسم الإعدادات الافتراضية فإنّ التابع يطلق الاستثناء ValueError. | + | إن كان هناك صنف يحمل الاسم ذاته فإنّ التابع يطلق الاستثناء <code>[[Python/configparser#.D8.A7.D9.84.D8.A7.D8.B3.D8.AA.D8.AB.D9.86.D8.A7.D8.A1 configparser.DuplicateSectionError|DuplicateSectionError]]</code>. وإن كان الاسم المعطى هو اسم قسم الإعدادات الافتراضية فإنّ التابع يطلق الاستثناء <code>ValueError</code>. |
لا يجري التحقّق من نوع القسم الأمر الذي يسمح للمستخدم بإنشاء أسماء أقسام غير نصية، وهذا السلوك غير مدعوم وقد يتسبب في حدوث أخطاء داخلية. | لا يجري التحقّق من نوع القسم الأمر الذي يسمح للمستخدم بإنشاء أسماء أقسام غير نصية، وهذا السلوك غير مدعوم وقد يتسبب في حدوث أخطاء داخلية. | ||
| سطر 37: | سطر 35: | ||
</syntaxhighlight> | </syntaxhighlight> | ||
| − | |||
| − | |||
== مصادر == | == مصادر == | ||
مراجعة 17:17، 30 نوفمبر 2018
يضيف التابع قسمًا يحمل الاسم المعطى إلى نسخة الصنف RawConfigParser.
البنية العامة
add_section(section)
المعاملات
section
اسم القسم المراد إضافته إلى ملف الإعدادات.
القيمة المعادة
إن كان هناك صنف يحمل الاسم ذاته فإنّ التابع يطلق الاستثناء DuplicateSectionError. وإن كان الاسم المعطى هو اسم قسم الإعدادات الافتراضية فإنّ التابع يطلق الاستثناء ValueError.
لا يجري التحقّق من نوع القسم الأمر الذي يسمح للمستخدم بإنشاء أسماء أقسام غير نصية، وهذا السلوك غير مدعوم وقد يتسبب في حدوث أخطاء داخلية.
أمثلة
يبين المثال التالي طريقة عمل التابع:
>>> import configparser
>>> rconfig = configparser.RawConfigParser()
>>> rconfig.read('config.cfg')
['config.cfg']
>>> rconfig.sections()
['bitbucket.org', 'topsecret.server.com']
>>> rconfig.add_section(99)
>>> rconfig.sections()
['bitbucket.org', 'topsecret.server.com', 99]