الفرق بين المراجعتين لصفحة: «Python/ConfigParser/add section»

المراجعة الحالية بتاريخ 11:31، 30 نوفمبر 2018

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

@@ سطر 1: / سطر 1: @@
 <noinclude>{{DISPLAYTITLE:التابع <code>ConfigParser.add_section()‎‎</code> في بايثون}}</noinclude>
-يضيف التابع قسمًا يحمل الاسم المعطى إلى نسخة الصنف ConfigParser.
+يضيف التابع قسمًا يحمل الاسم المعطى إلى نسخة الصنف <code>[[Python/ConfigParser|ConfigParser]]</code>.
 == البنية العامة ==
@@ سطر 7: / سطر 7: @@
 add_section(section)
 </syntaxhighlight>
-‎
-== المعاملات ==
+== ‎المعاملات ==
 === <code>section</code> ===
-اسم القسم المراد إضافته إلى نسخة الصنف ConfigParser.
+[[Python/str|سلسلة نصية]] تتضمن اسم القسم المراد إضافته إلى نسخة الصنف <code>[[Python/ConfigParser|ConfigParser]]</code>.
 == القيمة المعادة ==
-إن كان هناك قسم يحمل الاسم ذاته فإنّ التابع يطلق الاستثناء DuplicateSectionError. وإن كان الاسم المعطى مطابقًا لاسم قسم الإعدادات الافتراضية فإنّ التابع يطلق الاستثناء ValueError. يجب أن يكون الاسم المعطى سلسلة نصية وإلّا فإنّ التابع يطلق الاستثناء TypeError.
+إن كان هناك قسم يحمل الاسم ذاته فإنّ التابع يطلق الاستثناء <code>DuplicateSectionError</code>. وإن كان الاسم المعطى مطابقًا لاسم قسم الإعدادات الافتراضية فإنّ التابع يطلق الاستثناء <code>ValueError</code>. يجب أن يكون الاسم المعطى [[Python/str|سلسلة نصية]] وإلّا فإنّ التابع يطلق الاستثناء <code>TypeError</code>.
-ملاحظة: يطلق التابع الاستثناء TypeError عند استخدام الأسماء غير النصية في الإصدار 3.2 وما بعده من بايثون.
+'''ملاحظة:''' يطلق التابع الاستثناء <code>TypeError</code> عند استخدام الأسماء غير النصية في الإصدار 3.2 وما بعده من بايثون.
 == أمثلة ==
@@ سطر 22: / سطر 24: @@
 <syntaxhighlight lang="python3">
+>>> 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
 </syntaxhighlight>
 == انظر أيضًا ==
+* التابع <code>[[Python/ConfigParser/remove section|remove_section()]]</code>‎: يحذف التابع القسم المعطى من ملف الإعدادات.
 == مصادر ==