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

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

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

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

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

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

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

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

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

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

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

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

هذه الدالة مكافئة للدالة <code>sorted(iterable, key=key)[:n]‎</code>

== أمثلة ==

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

<syntaxhighlight lang="python3">

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

</syntaxhighlight>

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

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

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