الفرق بين المراجعتين ل"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 في توثيق بايثون الرسمي.