الفرق بين المراجعتين لصفحة: «Python/cgi/parse multipart»
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE:الدالة <code>cgi.parse_multipart()</code> في بايثون}}</noinclude> تحلّل الدالة المدخلات من نوع mul...' |
لا ملخص تعديل |
||
| (2 مراجعات متوسطة بواسطة نفس المستخدم غير معروضة) | |||
| سطر 8: | سطر 8: | ||
cgi.parse_multipart(fp, pdict, encoding="utf-8", errors="replace") | cgi.parse_multipart(fp, pdict, encoding="utf-8", errors="replace") | ||
</syntaxhighlight> | </syntaxhighlight> | ||
== المعاملات == | == المعاملات == | ||
=== fp === | === <code>fp</code> === | ||
الملف المُدخل. | الملف المُدخل. | ||
=== pdict === | === <code>pdict</code> === | ||
قاموس يحتوي على المعاملات في ترويسة Content-Type. | قاموس يحتوي على المعاملات في ترويسة Content-Type. | ||
=== encoding === | === <code>encoding</code> === | ||
ترميز الطلب. | ترميز الطلب. | ||
'''ملاحظة:''' أضيف المعاملان encoding و errors في الإصدار 3.7 من بايثون. كذلك أصبحت القيمة المعادة للحقول التي لا تتضمن ملفّات قائمة من السلاسل النصية وليس من كائنات bytes. | '''ملاحظة:''' أضيف المعاملان <code>encoding</code> و <code>errors</code> في الإصدار 3.7 من بايثون. كذلك أصبحت القيمة المعادة للحقول التي لا تتضمن ملفّات قائمة من السلاسل النصية وليس من كائنات bytes. | ||
== القيمة المعادة == | == القيمة المعادة == | ||
تعيد الدالة قاموسًا مشابهًا للقاموس الذي تعيده الدالة urllib.parse.parse_qs(). مفاتيح هذا القاموس هي أسماء الحقول في النموذج، وكلّ قيمة في القاموس هي قائمة من القيم الخاصّة بالحقل المقابل. تعيد الدالة قائمة من السلاسل النصية إن لم تتضمّن الحقول ملفّات. | تعيد الدالة [[Python/dict|قاموسًا]] مشابهًا للقاموس الذي تعيده الدالة <code>[[Python/urllib/parse/parse qs|urllib.parse.parse_qs()]]</code>. مفاتيح هذا القاموس هي أسماء الحقول في النموذج، وكلّ قيمة في القاموس هي قائمة من القيم الخاصّة بالحقل المقابل. تعيد الدالة قائمة من السلاسل النصية إن لم تتضمّن الحقول ملفّات. | ||
يمكن استخدام هذه الدالة مع الملفات ذات الأحجام الصغيرة (لا يتعدى حجمها بضعة كيلوبايتات)، أمّا الملفات الكبيرة فيمكن التعامل معها باستخدام الصنف FieldStorage. | يمكن استخدام هذه الدالة مع الملفات ذات الأحجام الصغيرة (لا يتعدى حجمها بضعة كيلوبايتات)، أمّا الملفات الكبيرة فيمكن التعامل معها باستخدام الصنف <code>FieldStorage</code>. | ||
== انظر أيضًا == | |||
*الدالة <code>[[Python/cgi/parse|cgi.parse()]]</code>: تحلّل الدالة الاستعلام الموجود في بيئة معينة أو في ملف معيّن. | |||
*الدالة <code>[[Python/cgi/parse qs|cgi.parse_qs()]]</code>: هذه الدالة مهملة في هذه الوحدة، وهي موجودة لغرض التوافق مع الإصدارات السابقة من بايثون. استخدم الدالة <code>[[Python/urllib/parse/parse qs|urllib.parse.parse_qs()]]</code> عوضًا عنها. | |||
*الدالة <code>[[Python/cgi/parse qsl|cgi.parse_qsl()]]</code>: هذه الدالة مهملة في هذه الوحدة، وهي موجودة لغرض التوافق مع الإصدارات السابقة من بايثون. استخدم الدالة <code>[[Python/urllib/parse/parse qsl|urllib.parse.parse_qsl()]]</code> عوضًا عنها. | |||
*الدالة <code>[[Python/cgi/parse header|cgi.parse_header()]]</code>: تحلّل الدالة ترويسة MIME (مثل Content-Type) إلى قيمة رئيسة و<nowiki/>[[Python/dict|قاموسٍ]] من المعاملات. | |||
== مصادر == | == مصادر == | ||
* [https://docs.python.org/3/library/cgi.html#cgi. | * [https://docs.python.org/3/library/cgi.html#cgi.parse_multipart صفحة Common Gateway Interface support في توثيق بايثون الرسمي.] | ||
[[تصنيف:Python]] | [[تصنيف:Python]] | ||
[[تصنيف:Python Modules]] | [[تصنيف:Python Modules]] | ||
المراجعة الحالية بتاريخ 17:22، 27 ديسمبر 2018
تحلّل الدالة المدخلات من نوع 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.
انظر أيضًا
- الدالة
cgi.parse(): تحلّل الدالة الاستعلام الموجود في بيئة معينة أو في ملف معيّن.
- الدالة
cgi.parse_qs(): هذه الدالة مهملة في هذه الوحدة، وهي موجودة لغرض التوافق مع الإصدارات السابقة من بايثون. استخدم الدالةurllib.parse.parse_qs()عوضًا عنها.
- الدالة
cgi.parse_qsl(): هذه الدالة مهملة في هذه الوحدة، وهي موجودة لغرض التوافق مع الإصدارات السابقة من بايثون. استخدم الدالةurllib.parse.parse_qsl() عوضًا عنها.
- الدالة
cgi.parse_header(): تحلّل الدالة ترويسة MIME (مثل Content-Type) إلى قيمة رئيسة وقاموسٍ من المعاملات.