Python/Connection/create function

ينشئ التابع دالة معرفة من قبل المستخدم يمكن استعمالها لاحقًا ضمن جمل SQL.

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

create_function(name, num_params, func)

‎المعاملات

name

اسم الدالة المراد إنشاؤها.

num_params

عدد المعاملات التي تستقبلها الدالة (يمكن تعيين القيمة ‎-1 لهذا المعامل لتستقبل الدالة أي عدد من المعاملات).

func

كائن قابل للاستدعاء callable في بايثون، والذي سيستدعى كدالة SQL.

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

يمكن للدالة أن تعيد أيّة قيمة من القيم المدعومة في SQLite وهي: bytes، str، int، float، None.

أمثلة

يبين المثال التالي طريقة استخدام الدالة:

import sqlite3
import hashlib

def md5sum(t):
    return hashlib.md5(t).hexdigest()

con = sqlite3.connect(":memory:")
con.create_function("md5", 1, md5sum)
cur = con.cursor()
cur.execute("select md5(?)", (b"foo",))
print(cur.fetchone()[0])

انظر أيضًا

• التابع Connection.create_aggregate()‎:ينشئ التابع دالة تجميع aggregate function معرّفة من قبل المستخدم.
• التابع Connection.create_collation()‎:ينشئ التابع ترتيبًا collation يحمل الاسم المعطى مع الكائن القابل للاستدعاء المعطى.

مصادر

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