التابع FieldStorage.getfirst() في بايثون
يعيد هذا التابع قيمة واحدة دائمًا ترتبط بالحقل الذي يحمل الاسم المعطى، ويعيد التابع القيمة الأولى فقط في حال إرسال عدد من القيم التي تحمل هذا الاسم. يجدر الانتباه هنا إلى أنّ ترتيب العناصر قد يختلف باختلاف المتصفّح ولا يجدر الاعتماد عليه.
ملاحظة: تحدّد بعض الإصدارات الحديثة من معايير HTML الترتيب المتّبع في تزويد قيم الحقول، ولكن التحقّق ممّا إذا كان الطلب قادمًا من متصفّح يعتمد هذه المعايير أم لا، أو أنّ الطلب قادم من متصفّح أصلًا أمر صعبٌ وقد يتسبب في الوقوع في أخطاء كثيرة.
البنية العامة
FieldStorage.getfirst(name, default=None)
المعاملات
name
اسم الحقل المراد جلب القيمة المرتبطة به.
default
إن لم يعثر التابع على الحقل ذي الاسم المعطى أو القيمة المطلوبة في النموذج فإنّه يعيد القيمة المحدّدة في المعامل الاختياري default والذي يأخذ القيمة الافتراضية None.
القيمة المعادة
يعيد هذا التابع قيمة واحدة دائمًا ترتبط بالحقل الذي يحمل الاسم المعطى.
أمثلة
يبين المثال التالي كيفية استخدام التابع:
import cgi
form = cgi.FieldStorage()
user = form.getfirst("user", "").upper() # هكذا تكون آمنة
انظر أيضًا
- التابع
FieldStorage.getlist(): يعيد هذا التابع دائمًا قائمة بالقيم المرتبطة بالحقل المعطى.