عرض مصدر Python/Headers/add header

<noinclude>{{DISPLAYTITLE:الدالة <code>Header.add_header()‎‎</code> في بايثون}}</noinclude>

يضيف التابع ترويسة (يمكن أن تكون متعددة القيم) مع معاملات MIME اختيارية تُحدّد بواسطة المعاملات المفتاحية.

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

<syntaxhighlight lang="python3">
add_header(name, value, **_params)
</syntaxhighlight>
‎
== المعاملات ==
‎name
حقل الترويسة المراد إضافته.

يمكن استخدام المعاملات المفتاحية لتعيين معاملات MIME لحقل الترويسة. يجب أن يكون كل معامل سلسلة نصية أو يحمل القيمة None، ويجري تحويل جميع الشرطات السفلية underscores إلى خطوط فاصلة dashes وذلك لأنّ بايثون لا تسمح باستخدام الخطوط الفاصلة في المعرّفات، ولكن الكثير من معاملات MIME يتضمّن خطوطًا فاصلة.

إن كانت قيمة المعامل سلسلة نصية، فإنّها تضاف إلى معاملات قيم الترويسة بالصيغة name="value"‎. أما إن كانت قيمة المعامل هي None، فسيضاف اسم المعامل فقط. (هناك بعض معاملات MIME التي لا تمتلك أي قيمة).

== أمثلة ==

يبين المثال التالي طريقة استخدام هذا التابع:

<syntaxhighlight lang="python3">
h.add_header('content-disposition', 'attachment', filename='bud.gif')
</syntaxhighlight>
يضيف التعبير أعلاه الترويسة التالية:
<syntaxhighlight lang="text">
Content-Disposition: attachment; filename="bud.gif"
</syntaxhighlight>

== مصادر ==
* [https://docs.python.org/3/library/wsgiref.html#wsgiref.Headers.add_header قسم WSGI environment utilities في صفحة WSGI Utilities and Reference Implementation في توثيق بايثون الرسمي.]

[[تصنيف:Python]]
[[تصنيف:Python Modules]]
[[تصنيف:Python Methods]]