الفرق بين المراجعتين لصفحة: «Python/heapq/nlargest»

من موسوعة حسوب
< Python‏ | heapq
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE:الدالة <code>heapq.nlargest()‎</code> في بايثون}}</noinclude> تعيد الدالة قائمة تضمّ n من أكبر الع...'
 
لا ملخص تعديل
 
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE:الدالة <code>heapq.nlargest()‎</code> في بايثون}}</noinclude>
<noinclude>{{DISPLAYTITLE:الدالة <code>heapq.nlargest()‎</code> في بايثون}}</noinclude>


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


== البنية العامة ==
== البنية العامة ==
سطر 19: سطر 19:
===<code>key</code>===
===<code>key</code>===


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


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


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


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


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


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


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

المراجعة الحالية بتاريخ 13:12، 6 أغسطس 2018


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

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

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

المعاملات

n

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

iterable

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

key

يحدّد هذا المعامل -في حال تعيينه- دالة ذات معامل واحد تُستخدم لاستخلاص مفتاح مقارنة من كل عنصر في المكرّر، مثل: 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 المعرّفة بواسطة كائن التكرار.

مصادر

صفحة General calendar-related functions في توثيق بايثون الرسمي.