التابع Counter.most_common()‎ في بايثون

يعيد هذا التابع كائنًا مكرِّرًا يتضمّن عناصر تتكرّر فيه حسب قيمة التعداد في كائن التعداد.

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

c.‎most_common([n])

المعاملات

n

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

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

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

أمثلة

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

>>> Counter('abracadabra').most_common(3)  
[('a', 5), ('r', 2), ('b', 2)]

انظر أيضًا

• التابع elements()‎: :يعيد هذا التابع كائنًا مكرِّرًا يتضمّن عناصر تتكرّر فيه حسب قيمة التعداد في كائن التعداد.
• التابع substract()‎: :يطرح التابع العناصر من الكائن المكرِّر أو من كائن mapping آخر (أو عداد آخر).

مصادر

قسم Counter objects في صفحة Container Datatype في توثيق بايثون الرسمي.