الدالة Header.add_header() في بايثون
يضيف التابع ترويسة (يمكن أن تكون متعددة القيم) مع معاملات 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"