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

يطرح التابع العناصر من الكائن المكرِّر أو من كائن mapping آخر (أو عداد آخر).

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

c.subtract([iterable-or-mapping])

المعاملات

iterable أو mapping

الكائن المكرِّر أو كائن mapping آخر (أو عداد آخر) الذي ستُطرح منه العناصر.

n

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

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

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

ملاحظة: هذا التابع جديد في الإصدار 3.2 من بايثون.

أمثلة

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

>>> c = Counter(a=4, b=2, c=0, d=-2)
>>> d = Counter(a=1, b=2, c=3, d=4)
>>> c.subtract(d)
>>> c
Counter({'a': 3, 'b': 0, 'c': -3, 'd': -6})

انظر أيضًا

• التابع elements()‎: :يعيد هذا التابع كائنًا مكرِّرًا يتضمّن عناصر تتكرّر فيه حسب قيمة التعداد في كائن التعداد.
• التابع most_common()‎: :يعيد التابع قائمة بالعناصر الأكثر تكرارًا إلى جانب عدد مرات التكرار.

مصادر

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