عرض مصدر Python/FieldStorage/getfirst

<noinclude>{{DISPLAYTITLE:التابع <code>FieldStorage.getfirst()‎‎</code> في بايثون}}</noinclude>
يعيد هذا التابع قيمة واحدة دائمًا ترتبط بالحقل الذي يحمل الاسم المعطى، ويعيد التابع القيمة الأولى فقط في حال إرسال عدد من القيم التي تحمل هذا الاسم. يجدر الانتباه هنا إلى أنّ ترتيب العناصر قد يختلف باختلاف المتصفّح ولا يجدر الاعتماد عليه. 

'''ملاحظة:''' تحدّد بعض الإصدارات الحديثة من معايير HTML الترتيب المتّبع في تزويد قيم الحقول، ولكن التحقّق ممّا إذا كان الطلب قادمًا من متصفّح يعتمد هذه المعايير أم لا، أو أنّ الطلب قادم من متصفّح أصلًا أمر صعبٌ وقد يتسبب في الوقوع في أخطاء كثيرة. 
== البنية العامة ==

<syntaxhighlight lang="python3">
FieldStorage.getfirst(name, default=None)
</syntaxhighlight>

== ‎المعاملات ==

=== <code>name</code> ===
اسم الحقل المراد جلب القيمة المرتبطة به.

=== <code>default</code> ===
إن لم يعثر التابع على الحقل ذي الاسم المعطى أو القيمة المطلوبة في النموذج فإنّه يعيد القيمة المحدّدة في المعامل الاختياري <code>default</code> والذي يأخذ القيمة الافتراضية <code>None</code>.

== القيمة المعادة ==
يعيد هذا التابع قيمة واحدة دائمًا ترتبط بالحقل الذي يحمل الاسم المعطى.

== أمثلة ==

يبين المثال التالي كيفية استخدام التابع:

<syntaxhighlight lang="python3">
import cgi
form = cgi.FieldStorage()
user = form.getfirst("user", "").upper()    # This way it's safe.
for item in form.getlist("item"):
    do_something(item)
</syntaxhighlight>

== انظر أيضًا ==
* التابع <code>[[Python/FieldStorage/getlist|FieldStorage.getlist()]]</code>‎: يعيد هذا التابع دائمًا قائمة بالقيم المرتبطة بالحقل المعطى.
== مصادر ==
* [https://docs.python.org/3/library/cgi.html#cgi.FieldStorage.getfirst صفحة Common Gateway Interface support في توثيق بايثون الرسمي.]

[[تصنيف:Python]]
[[تصنيف:Python Modules]]
[[تصنيف:Python Methods]]