التابع RawConfigParser.add_section()‎‎ في بايثون

من موسوعة حسوب
اذهب إلى التنقل اذهب إلى البحث


يضيف التابع قسمًا يحمل الاسم المعطى إلى نسخة الصنف 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]

مصادر