الدالة heapq.nsmallest()
في بايثون
اذهب إلى التنقل
اذهب إلى البحث
تعيد الدالة قائمة تضمّ العدد المحدّد من أصغر العناصر في مجموعة البيانات dataset المعرّفة بواسطة كائنات التكرار المعطى.
البنية العامة
heapq.nsmallest(n, iterable, key=None)
المعاملات
n
عدد العناصر المطلوبة.
iterable
كائن التكرار المراد البحث فيه عن العناصر.
key
يحدّد هذا المعامل -في حال تعيينه- دالة ذات معامل واحد تُستخدم لاستخلاص مفتاح مقارنة من كل عنصر في المكرّر، مثل: key=str.lower
.
القيمة المعادة
تعيد الدالة قائمة تضمّ n
من أكبر العناصر في مجموعة البيانات dataset المعرّفة بواسطة كائن التكرار.
هذه الدالة مكافئة للدالة sorted(iterable, key=key)[:n]
أمثلة
يبين المثال التالي آلية عمل التابع:
>>> import heapq
>>> li = [6, 7, 9, 4, 3, 5, 8, 10, 1]
>>> heapq.heapify(li)
>>> heapq.nsmallest(3, li)
[1, 3, 4]
انظر أيضًا
- الدالة
heapmerge
(): تدمج الدالة عدة مدخلات مفروزة في مخرج مفرد مفروز. - الدالة
nlargest
(): تعيد الدالة قائمة تضمّ العدد المحدّد من أكبر العناصر في مجموعة البيانات dataset المعرّفة بواسطة كائن التكرار المعطى.
مصادر
صفحة General calendar-related functions في توثيق بايثون الرسمي.