عرض مصدر Python/heapq/nlargest

<noinclude>{{DISPLAYTITLE:الدالة <code>heapq.nlargest()‎</code> في بايثون}}</noinclude>

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

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

<syntaxhighlight lang="python3">
heapq.nlargest(n, iterable, key=None)
</syntaxhighlight>

== المعاملات ==

===<code>n</code>===
عدد العناصر المطلوبة.

===<code>iterable</code>===
كائن التكرار المراد البحث فيه عن العناصر.

===<code>key</code>===

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

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

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

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

== أمثلة ==

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

<syntaxhighlight lang="python3">

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

</syntaxhighlight>

== انظر أيضًا ==
* الدالة [[Python/heapq/heapmerge|<code>heapmerge</code>()‎]]: تدمج الدالة عدة مدخلات مفروزة في مخرج مفرد مفروز.
* الدالة [[Python/heapq/nsmallest|<code>nsmallest</code>()‎]]: تعيد الدالة قائمة تضمّ n من أصغر العناصر في مجموعة البيانات dataset المعرّفة بواسطة المكرَّرات.

== مصادر ==
[https://docs.python.org/3/library/heapq.html#heapq.nlargest صفحة General calendar-related functions في توثيق بايثون الرسمي.]


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