الدالة `heapq.nlargest()‎` في بايثون

تعيد الدالة قائمة تضمّ العدد المحدّد من أكبر العناصر في مجموعة البيانات dataset المعرّفة بواسطة كائنات التكرار المعطى.

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

heapq.nlargest(n, iterable, key=None)

عدد العناصر المطلوبة.

كائن التكرار المراد البحث فيه عن العناصر.

يحدّد هذا المعامل -في حال تعيينه- دالة ذات معامل واحد تُستخدم لاستخلاص مفتاح مقارنة من كل عنصر في المكرّر، مثل: key=str.lower.

تعيد الدالة قائمة تضمّ n من أكبر العناصر في مجموعة البيانات dataset المعرّفة بواسطة كائن التكرار.

هذه الدالة مكافئة للدالة sorted(iterable, key=key, reverse=True)[:n]‎

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

>>> import heapq
>>> li = [6, 7, 9, 4, 3, 5, 8, 10, 1]
>>> heapq.heapify(li)
>>> heapq.nlargest(3, li)
[10, 9, 8]

الدالة heapmerge()‎: تدمج الدالة عدة مدخلات مفروزة في مخرج مفرد مفروز.
الدالة nsmallest()‎: تعيد الدالة قائمة تضمّ العدد المحدّد من أصغر العناصر في مجموعة البيانات dataset المعرّفة بواسطة كائن التكرار.