الفرق بين المراجعتين لصفحة: «Python/FieldStorage/getfirst»
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE:التابع <code>FieldStorage.getfirst()</code> في بايثون}}</noinclude> يعيد هذا التابع قيمة واحدة دائ...' |
لا ملخص تعديل |
||
| سطر 8: | سطر 8: | ||
FieldStorage.getfirst(name, default=None) | FieldStorage.getfirst(name, default=None) | ||
</syntaxhighlight> | </syntaxhighlight> | ||
== | == المعاملات == | ||
=== <code>name</code> === | === <code>name</code> === | ||
اسم الحقل المراد جلب القيمة المرتبطة به. | اسم الحقل المراد جلب القيمة المرتبطة به. | ||
=== <code>default</code> === | === <code>default</code> === | ||
إن لم يعثر التابع على الحقل ذي الاسم المعطى أو القيمة المطلوبة في النموذج فإنّه يعيد القيمة المحدّدة في المعامل الاختياري default والذي يأخذ القيمة الافتراضية None. | إن لم يعثر التابع على الحقل ذي الاسم المعطى أو القيمة المطلوبة في النموذج فإنّه يعيد القيمة المحدّدة في المعامل الاختياري <code>default</code> والذي يأخذ القيمة الافتراضية <code>None</code>. | ||
== القيمة المعادة == | == القيمة المعادة == | ||
| سطر 32: | سطر 33: | ||
== انظر أيضًا == | == انظر أيضًا == | ||
* التابع FieldStorage.getlist(): يعيد هذا التابع دائمًا قائمة بالقيم المرتبطة بالحقل المعطى. | * التابع <code>[[Python/FieldStorage/getlist|FieldStorage.getlist()]]</code>: يعيد هذا التابع دائمًا قائمة بالقيم المرتبطة بالحقل المعطى. | ||
== مصادر == | == مصادر == | ||
* [https://docs.python.org/3/library/cgi.html#cgi.FieldStorage.getfirst صفحة Common Gateway Interface support في توثيق بايثون الرسمي.] | * [https://docs.python.org/3/library/cgi.html#cgi.FieldStorage.getfirst صفحة Common Gateway Interface support في توثيق بايثون الرسمي.] | ||
مراجعة 21:15، 27 ديسمبر 2018
يعيد هذا التابع قيمة واحدة دائمًا ترتبط بالحقل الذي يحمل الاسم المعطى، ويعيد التابع القيمة الأولى فقط في حال إرسال عدد من القيم التي تحمل هذا الاسم. يجدر الانتباه هنا إلى أنّ ترتيب العناصر قد يختلف باختلاف المتصفّح ولا يجدر الاعتماد عليه.
ملاحظة: تحدّد بعض الإصدارات الحديثة من معايير HTML الترتيب المتّبع في تزويد قيم الحقول، ولكن التحقّق ممّا إذا كان الطلب قادمًا من متصفّح يعتمد هذه المعايير أم لا، أو أنّ الطلب قادم من متصفّح أصلًا أمر صعبٌ وقد يتسبب في الوقوع في أخطاء كثيرة.
البنية العامة
FieldStorage.getfirst(name, default=None)
المعاملات
name
اسم الحقل المراد جلب القيمة المرتبطة به.
default
إن لم يعثر التابع على الحقل ذي الاسم المعطى أو القيمة المطلوبة في النموذج فإنّه يعيد القيمة المحدّدة في المعامل الاختياري default والذي يأخذ القيمة الافتراضية None.
القيمة المعادة
يعيد هذا التابع قيمة واحدة دائمًا ترتبط بالحقل الذي يحمل الاسم المعطى.
أمثلة
يبين المثال التالي كيفية استخدام التابع:
import cgi
form = cgi.FieldStorage()
user = form.getfirst("user", "").upper() # This way it's safe.
for item in form.getlist("item"):
do_something(item)
انظر أيضًا
- التابع
FieldStorage.getlist(): يعيد هذا التابع دائمًا قائمة بالقيم المرتبطة بالحقل المعطى.