عرض مصدر Python/Counter/most common

<noinclude>{{DISPLAYTITLE:التابع <code>Counter.most_common()‎</code> في بايثون}}</noinclude>
يعيد هذا التابع كائنًا مكرِّرًا يتضمّن عناصر تتكرّر فيه حسب قيمة التعداد في كائن التعداد.

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

<syntaxhighlight lang="python3">
c.‎most_common([n])
</syntaxhighlight>

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

=== <code>n</code> ===

إن لم يأخذ هذا المعامل أي قيمة أو أخذ القيمة <code>None</code>، فإنّ التابع يعيد جميع العناصر في العداد. وجدير بالذكر أنّه لا يوجد ترتيب معيّن للعناصر التي تمتلك تعدادًا متساويًا.

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

يعيد التابع قائمة بالعناصر الأكثر تكرارًا إلى جانب عدد مرات التكرار. يمكن تحديد عدد العناصر المطلوبة عن طريق تمرير القيمة إلى المعامل <code>n</code>.

== أمثلة ==

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

<syntaxhighlight lang="python3">
>>> Counter('abracadabra').most_common(3)  
[('a', 5), ('r', 2), ('b', 2)]
</syntaxhighlight>

== انظر أيضًا ==

* [[Python/elements|التابع <code>elements()‎</code>: ]] :يعيد هذا التابع كائنًا مكرِّرًا يتضمّن عناصر تتكرّر فيه حسب قيمة التعداد في كائن التعداد.
* [[Python/substract|التابع <code>substract()‎</code>: ]] :يطرح التابع العناصر من الكائن المكرِّر أو من كائن mapping آخر (أو عداد آخر).

== مصادر ==
[https://docs.python.org/3/library/collections.html#collections.Counter.most_common قسم Counter objects في صفحة Container Datatype في توثيق بايثون الرسمي.]


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