الفرق بين المراجعتين لصفحة: «Python/ConfigParser/optionxform»
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE:التابع <code>ConfigParser.optionxform()</code> في بايثون}}</noinclude> يحوّل التابع اسم الخيار الم...' |
لا ملخص تعديل |
||
| سطر 7: | سطر 7: | ||
optionxform(option) | optionxform(option) | ||
</syntaxhighlight> | </syntaxhighlight> | ||
== | == المعاملات == | ||
=== <code>option</code> === | === <code>option</code> === | ||
المعامل الذي سيحوّله التابع إلى صيغة ملفات الإعدادات. | المعامل الذي سيحوّله التابع إلى صيغة ملفات الإعدادات. | ||
== القيمة المعادة == | == القيمة المعادة == | ||
تعيد طريقة التنفيذ الافتراضية لهذا التابع اسم الخيار بعد تحويل جميع الحروف إلى أحرف صغيرة، ويمكن إعادة تعريف هذا التابع باستخدام أصناف فرعية ويمكن للمبرمج أن يعين خاصية لهذا الاسم في نسخ الصنف ConfigParser للتأثير على طريقة عمل التابع. | تعيد طريقة التنفيذ الافتراضية لهذا التابع اسم الخيار بعد تحويل جميع الحروف إلى أحرف صغيرة، ويمكن إعادة تعريف هذا التابع باستخدام أصناف فرعية ويمكن للمبرمج أن يعين خاصية لهذا الاسم في نسخ الصنف <code>[[Python/ConfigParser|ConfigParser]]</code> للتأثير على طريقة عمل التابع. | ||
لا حاجة لإنشاء صنف فرعي من المحلّل لاستخدام هذا التابع، ويمكن تعيينه في نسخة من الصنف لدالة تأخذ وسيطًا نصّيًّا ويعيد سلسلة نصية. يؤدي تعيين التابع إلى سلسلة نصية -على سبيل المثال- إلى جعل أسماء الخيارات حساسة لحالة الأحرف: | لا حاجة لإنشاء صنف فرعي من المحلّل لاستخدام هذا التابع، ويمكن تعيينه في نسخة من الصنف لدالة تأخذ وسيطًا نصّيًّا ويعيد [[Python/str|سلسلة نصية]]. يؤدي تعيين التابع إلى [[Python/str|سلسلة نصية]] -على سبيل المثال- إلى جعل أسماء الخيارات حساسة لحالة الأحرف:<syntaxhighlight lang="python3"> | ||
cfgparser = ConfigParser() | cfgparser = ConfigParser() | ||
cfgparser.optionxform = str | cfgparser.optionxform = str | ||
</syntaxhighlight>يجدر التنبيه إلى أنّ المسافات البيضاء حول أسماء الخيارات تُحذف عند قراءة ملفات الإعدادات قبل استدعاء التابع <code>optionxform()</code>. | |||
يجدر التنبيه إلى أنّ المسافات البيضاء حول أسماء الخيارات تُحذف عند قراءة ملفات الإعدادات قبل استدعاء التابع optionxform(). | |||
== أمثلة == | == أمثلة == | ||
المراجعة الحالية بتاريخ 19:29، 30 نوفمبر 2018
يحوّل التابع اسم الخيار المعطى وكما هو موجود في ملف الإعدادات أو كما هو ممرّر إلى التابع عن طريق الشيفرة التي يكتبها المستخدم إلى الصيغة التي يجب استخدامها في البنية الداخلية لملفات الإعدادات.
البنية العامة
optionxform(option)
المعاملات
option
المعامل الذي سيحوّله التابع إلى صيغة ملفات الإعدادات.
القيمة المعادة
تعيد طريقة التنفيذ الافتراضية لهذا التابع اسم الخيار بعد تحويل جميع الحروف إلى أحرف صغيرة، ويمكن إعادة تعريف هذا التابع باستخدام أصناف فرعية ويمكن للمبرمج أن يعين خاصية لهذا الاسم في نسخ الصنف ConfigParser للتأثير على طريقة عمل التابع.
لا حاجة لإنشاء صنف فرعي من المحلّل لاستخدام هذا التابع، ويمكن تعيينه في نسخة من الصنف لدالة تأخذ وسيطًا نصّيًّا ويعيد سلسلة نصية. يؤدي تعيين التابع إلى سلسلة نصية -على سبيل المثال- إلى جعل أسماء الخيارات حساسة لحالة الأحرف:
cfgparser = ConfigParser()
cfgparser.optionxform = str
يجدر التنبيه إلى أنّ المسافات البيضاء حول أسماء الخيارات تُحذف عند قراءة ملفات الإعدادات قبل استدعاء التابع optionxform().
أمثلة
يبين المثال التالي طريقة عمل التابع:
>>> config = """
... [Section1]
... Key = Value
...
... [Section2]
... AnotherKey = Value
... """
>>> typical = configparser.ConfigParser()
>>> typical.read_string(config)
>>> list(typical['Section1'].keys())
['key']
>>> list(typical['Section2'].keys())
['anotherkey']
>>> custom = configparser.RawConfigParser()
>>> custom.optionxform = lambda option: option
>>> custom.read_string(config)
>>> list(custom['Section1'].keys())
['Key']
>>> list(custom['Section2'].keys())
['AnotherKey']