الفرق بين المراجعتين لصفحة: «Python/Connection/set progress handler»
< Python | Connection
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE:التابع <code>Connection.set_progress_handler()</code> في بايثون}}</noinclude> يسجّل هذا التابع استدعاءً...' |
لا ملخص تعديل |
||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE:التابع <code>Connection.set_progress_handler()</code> في بايثون}}</noinclude> | <noinclude>{{DISPLAYTITLE:التابع <code>Connection.set_progress_handler()</code> في بايثون}}</noinclude> | ||
يسجّل هذا التابع استدعاءً خلفيًا يجري تنفيذه لكل n من تعليمات SQLite في الجهاز الافتراضي virtual machine. هذا التابع مفيد عند الحاجة إلى اجراء استدعاء من SQLite أثناء عملية طويلة، كتحديث واجهة رسومية مثلًا. | يسجّل هذا التابع استدعاءً خلفيًا يجري تنفيذه لكل <code>n</code> من تعليمات SQLite في الجهاز الافتراضي virtual machine. هذا التابع مفيد عند الحاجة إلى اجراء استدعاء من SQLite أثناء عملية طويلة، كتحديث واجهة رسومية مثلًا. | ||
== البنية العامة == | == البنية العامة == | ||
| سطر 8: | سطر 8: | ||
set_progress_handler(handler, n) | set_progress_handler(handler, n) | ||
</syntaxhighlight> | </syntaxhighlight> | ||
== المعاملات == | == المعاملات == | ||
=== <code>handler</code> === | === <code>handler</code> === | ||
يمكن استدعاء التابع مع تمرير القيمة None للمعامل handler للتخلص من أي استدعاء خلفي معدّ مسبقًا. | يمكن استدعاء التابع مع تمرير القيمة <code>None</code> للمعامل <code>handler</code> للتخلص من أي استدعاء خلفي معدّ مسبقًا. | ||
تؤدي إعادة قيمة غير الصفر من الاستدعاء الخلفي إلى إنهاء الاستعلام الحالي وإطلاق الاستثناء OperationalError. | تؤدي إعادة قيمة غير الصفر من الاستدعاء الخلفي إلى إنهاء الاستعلام الحالي وإطلاق الاستثناء <code>OperationalError</code>. | ||
=== <code>n</code> === | === <code>n</code> === | ||
| سطر 23: | سطر 22: | ||
== انظر أيضًا == | == انظر أيضًا == | ||
* [[Python/Connection/set_authorizer|التابع <code>Connection.set_authorizer()</code>]]:يسجّل هذا التابع كائن استدعاء خلفيٍّ، وينفّذ هذا الكائن في كل محاول للوصول إلى عمود في جدول ضمن قاعدة البيانات. | * [[Python/Connection/set_authorizer|التابع <code>Connection.set_authorizer()</code>]]:يسجّل هذا التابع كائن استدعاء خلفيٍّ، وينفّذ هذا الكائن في كل محاول للوصول إلى عمود في جدول ضمن قاعدة البيانات. | ||
* [[Python/Connection/set_trace_callback|التابع <code>Connection.set_trace_callback()</code>]]:يسجل التابع trace_callback يجري استدعاؤه لكل جملة SQL تنفّذ بواسطة SQLite. | * [[Python/Connection/set_trace_callback|التابع <code>Connection.set_trace_callback()</code>]]:يسجل التابع <code>trace_callback</code> يجري استدعاؤه لكل جملة [[SQL]] تنفّذ بواسطة SQLite. | ||
== مصادر == | == مصادر == | ||
المراجعة الحالية بتاريخ 20:46، 18 سبتمبر 2018
يسجّل هذا التابع استدعاءً خلفيًا يجري تنفيذه لكل n من تعليمات SQLite في الجهاز الافتراضي virtual machine. هذا التابع مفيد عند الحاجة إلى اجراء استدعاء من SQLite أثناء عملية طويلة، كتحديث واجهة رسومية مثلًا.
البنية العامة
set_progress_handler(handler, n)
المعاملات
handler
يمكن استدعاء التابع مع تمرير القيمة None للمعامل handler للتخلص من أي استدعاء خلفي معدّ مسبقًا.
تؤدي إعادة قيمة غير الصفر من الاستدعاء الخلفي إلى إنهاء الاستعلام الحالي وإطلاق الاستثناء OperationalError.
n
عدد تعليمات SQLite.
انظر أيضًا
- التابع
Connection.set_authorizer():يسجّل هذا التابع كائن استدعاء خلفيٍّ، وينفّذ هذا الكائن في كل محاول للوصول إلى عمود في جدول ضمن قاعدة البيانات. - التابع
Connection.set_trace_callback():يسجل التابعtrace_callbackيجري استدعاؤه لكل جملة SQL تنفّذ بواسطة SQLite.
مصادر
صفحة DB-API 2.0 interface for SQLite databases في توثيق بايثون الرسمي.