الفرق بين المراجعتين لصفحة: «Python/Headers/add header»
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE:الدالة <code>Header.add_header()</code> في بايثون}}</noinclude> يضيف التابع ترويسة (يمكن أن تكون...' |
لا ملخص تعديل |
||
| سطر 8: | سطر 8: | ||
add_header(name, value, **_params) | add_header(name, value, **_params) | ||
</syntaxhighlight> | </syntaxhighlight> | ||
== المعاملات == | == المعاملات == | ||
name | |||
=== <code>name</code> === | |||
حقل الترويسة المراد إضافته. | حقل الترويسة المراد إضافته. | ||
يمكن استخدام المعاملات المفتاحية لتعيين معاملات MIME لحقل الترويسة. يجب أن يكون كل معامل سلسلة نصية أو يحمل القيمة | === <code>value</code> === | ||
القيمة المرتبطة بالحقل المضاف. | |||
=== <code>**_params</code> === | |||
يمكن استخدام المعاملات المفتاحية لتعيين معاملات MIME لحقل الترويسة. يجب أن يكون كل معامل [[Python/str|سلسلة نصية]] أو يحمل القيمة <code>None</code>، ويجري تحويل جميع الشرطات السفلية underscores إلى خطوط فاصلة dashes وذلك لأنّ بايثون لا تسمح باستخدام الخطوط الفاصلة في المعرّفات، ولكن الكثير من معاملات MIME يتضمّن خطوطًا فاصلة. | |||
إن كانت قيمة المعامل سلسلة نصية، فإنّها تضاف إلى معاملات قيم الترويسة بالصيغة name="value". أما إن كانت قيمة المعامل هي | إن كانت قيمة المعامل سلسلة نصية، فإنّها تضاف إلى معاملات قيم الترويسة بالصيغة <code>name="value"</code>. أما إن كانت قيمة المعامل هي <code>None</code>، فسيضاف اسم المعامل فقط. (هناك بعض معاملات MIME التي لا تمتلك أي قيمة). | ||
== أمثلة == | == أمثلة == | ||
المراجعة الحالية بتاريخ 06:46، 27 ديسمبر 2018
يضيف التابع ترويسة (يمكن أن تكون متعددة القيم) مع معاملات MIME اختيارية تُحدّد بواسطة المعاملات المفتاحية.
البنية العامة
add_header(name, value, **_params)
المعاملات
name
حقل الترويسة المراد إضافته.
value
القيمة المرتبطة بالحقل المضاف.
**_params
يمكن استخدام المعاملات المفتاحية لتعيين معاملات MIME لحقل الترويسة. يجب أن يكون كل معامل سلسلة نصية أو يحمل القيمة None، ويجري تحويل جميع الشرطات السفلية underscores إلى خطوط فاصلة dashes وذلك لأنّ بايثون لا تسمح باستخدام الخطوط الفاصلة في المعرّفات، ولكن الكثير من معاملات MIME يتضمّن خطوطًا فاصلة.
إن كانت قيمة المعامل سلسلة نصية، فإنّها تضاف إلى معاملات قيم الترويسة بالصيغة name="value". أما إن كانت قيمة المعامل هي None، فسيضاف اسم المعامل فقط. (هناك بعض معاملات MIME التي لا تمتلك أي قيمة).
أمثلة
يبين المثال التالي طريقة استخدام هذا التابع:
h.add_header('content-disposition', 'attachment', filename='bud.gif')
يضيف التعبير أعلاه الترويسة التالية:
Content-Disposition: attachment; filename="bud.gif"