الفرق بين المراجعتين لصفحة: «Python/RawConfigParser/add section»
< Python | RawConfigParser
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE:التابع <code>RawConfigParser.add_section()</code> في بايثون}}</noinclude> يضيف التابع قسمًا يحمل الا...' |
لا ملخص تعديل |
||
| (1 مراجعات متوسطة بواسطة نفس المستخدم غير معروضة) | |||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE:التابع <code>RawConfigParser.add_section()</code> في بايثون}}</noinclude> | <noinclude>{{DISPLAYTITLE:التابع <code>RawConfigParser.add_section()</code> في بايثون}}</noinclude> | ||
يضيف التابع قسمًا يحمل الاسم المعطى إلى نسخة الصنف RawConfigParser. | يضيف التابع قسمًا يحمل الاسم المعطى إلى نسخة الصنف <code>[[Python/RawConfigParser|RawConfigParser]]</code>. | ||
== البنية العامة == | == البنية العامة == | ||
| سطر 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]