التابع Cursor.fetchone()‎ في بايثون

يجلب التابع الصفّ row التالي من نتيجة الاستعلام، ويعيد تسلسلًا واحدًا فقط، أو يعيد القيمة None في حال عدم توفّر المزيد من البيانات.

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

fetchone()

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

يعيد التابع تسلسلًا واحدًا فقط، أو يعيد القيمة None في حال عدم توفّر المزيد من البيانات.

أمثلة

يبين المثال التالي آلية عمل التابع:

>>> import sqlite3
>>> conn = sqlite3.connect(":memory:")
>>> cur = conn.cursor()
>>> cur.execute("create table people (name, age)")
<sqlite3.Cursor object at 0x7f0ea62989d0>
>>> name = "Mohammed"
>>> age = 30
>>> cur.execute("insert into people values (?, ?)", (name, age))
<sqlite3.Cursor object at 0x7f0ea62989d0>
>>> cur.execute("select * from people")
<sqlite3.Cursor object at 0x7f0ea62989d0>
>>> print(cur.fetchone())
('Mohammed', 30)

انظر أيضًا

• التابع Connection.fetchmany()‎:يجلب التابع المجموعة اللاحقة من الصفوف rows في نتيجة الاستعلام،
• التابع Connection.fetchall()‎:يجلب التابع جميع الصفوف (المتبقّية) في نتيجة الاستعلام، ويعيد النتيجة على هيئة قائمة.

مصادر

صفحة DB-API 2.0 interface for SQLite databases في توثيق بايثون الرسمي.