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

يضيف التابع قسمًا يحمل الاسم المعطى إلى نسخة الصنف ConfigParser.

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

add_section(section)

‎المعاملات

section

سلسلة نصية تتضمن اسم القسم المراد إضافته إلى نسخة الصنف ConfigParser.

القيمة المعادة

إن كان هناك قسم يحمل الاسم ذاته فإنّ التابع يطلق الاستثناء DuplicateSectionError. وإن كان الاسم المعطى مطابقًا لاسم قسم الإعدادات الافتراضية فإنّ التابع يطلق الاستثناء ValueError. يجب أن يكون الاسم المعطى سلسلة نصية وإلّا فإنّ التابع يطلق الاستثناء TypeError.

ملاحظة: يطلق التابع الاستثناء TypeError عند استخدام الأسماء غير النصية في الإصدار 3.2 وما بعده من بايثون.

أمثلة

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

>>> import configparser
>>> config = configparser.ConfigParser()
>>> config.read('config.cfg')
['config.cfg']
>>> config.sections()
['bitbucket.org', 'topsercret.server.com']
>>> config.add_section('User Interface')
>>> config.sections()
['bitbucket.org', 'topsercret.server.com', 'User Interface']
>>> config.add_section('User Interface')
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
  File "/usr/lib64/python3.6/configparser.py", line 1200, in add_section
    super().add_section(section)
  File "/usr/lib64/python3.6/configparser.py", line 659, in add_section
    raise DuplicateSectionError(section)
configparser.DuplicateSectionError: Section 'User Interface' already exists

انظر أيضًا

• التابع remove_section()‎: يحذف التابع القسم المعطى من ملف الإعدادات.

مصادر

• صفحة Configuration file parser في توثيق بايثون الرسمي.