الدالة cgi.parse_multipart()‎‎ في بايثون

من موسوعة حسوب


تحلّل الدالة المدخلات من نوع multipart/form-data (للملفات المرفوعة).

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

cgi.parse_multipart(fp, pdict, encoding="utf-8", errors="replace")

المعاملات

fp

الملف المُدخل.

pdict

قاموس يحتوي على المعاملات في ترويسة Content-Type.

encoding

ترميز الطلب.

ملاحظة: أضيف المعاملان encoding و errors في الإصدار 3.7 من بايثون. كذلك أصبحت القيمة المعادة للحقول التي لا تتضمن ملفّات قائمة من السلاسل النصية وليس من كائنات bytes.

القيمة المعادة

تعيد الدالة قاموسًا مشابهًا للقاموس الذي تعيده الدالة urllib.parse.parse_qs()‎. مفاتيح هذا القاموس هي أسماء الحقول في النموذج، وكلّ قيمة في القاموس هي قائمة من القيم الخاصّة بالحقل المقابل. تعيد الدالة قائمة من السلاسل النصية إن لم تتضمّن الحقول ملفّات.

يمكن استخدام هذه الدالة مع الملفات ذات الأحجام الصغيرة (لا يتعدى حجمها بضعة كيلوبايتات)، أمّا الملفات الكبيرة فيمكن التعامل معها باستخدام الصنف FieldStorage.

مصادر