عرض مصدر Python/Connection/create aggregate

<noinclude>{{DISPLAYTITLE:التابع <code>Connection.create_aggregate()‎</code> في بايثون}}</noinclude>
ينشئ التابع دالة تجميع aggregate function معرّفة من قبل المستخدم.

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

<syntaxhighlight lang="python3">
create_aggregate(name, num_params, aggregate_class)
</syntaxhighlight>
‎== المعاملات ==

=== <code>name</code> ===
اسم دالة التجميع المراد إنشاؤها.

=== <code>num_params</code> ===

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

=== <code>aggregate_class</code> ===

صنف تجميع يجب أن يتضمّن تابع step، والذي يأخذ المعامل num_params والذي يحدّد عدد المعاملات في الدالة التي ينشئها التابع (يمكن تعيين القيمة ‎-1 لهذا المعامل لتستقبل الدالة أي عدد من المعاملات)، وتابع finalize والذي سيعيد النتيجة النهائية من التجميع.

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

== أمثلة ==

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

<syntaxhighlight lang="python3">
import sqlite3

class MySum:
    def __init__(self):
        self.count = 0

    def step(self, value):
        self.count += value

    def finalize(self):
        return self.count

con = sqlite3.connect(":memory:")
con.create_aggregate("mysum", 1, MySum)
cur = con.cursor()
cur.execute("create table test(i)")
cur.execute("insert into test(i) values (1)")
cur.execute("insert into test(i) values (2)")
cur.execute("select mysum(i) from test")
print(cur.fetchone()[0])</syntaxhighlight>

== انظر أيضًا ==

* [[Python/Connection/create_function|التابع <code>Connection.create_function()‎</code>]]:ينشئ التابع دالة معرفة من قبل المستخدم يمكن استعمالها لاحقًا ضمن جمل [[SQL|SQL]].
* [[Python/Connection/create_collation|التابع <code>Connection.create_collation()‎</code>]]:ينشئ التابع ترتيبًا collation يحمل الاسم المعطى مع الكائن القابل للاستدعاء المعطى.

== مصادر ==
[https://docs.python.org/3/library/sqlite3.html#sqlite3.create_aggregate صفحة DB-API 2.0 interface for SQLite databases في توثيق بايثون الرسمي.]

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