عرض مصدر Python/Counter/substract

<noinclude>{{DISPLAYTITLE:التابع <code>Counter.substract()‎</code> في بايثون}}</noinclude>
يطرح التابع العناصر من الكائن المكرِّر أو من كائن mapping آخر (أو عداد آخر).

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

<syntaxhighlight lang="python3">
c.subtract([iterable-or-mapping])
</syntaxhighlight>

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

=== <code>iterable</code> أو <code>mapping</code> ===

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

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

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

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

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

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

== أمثلة ==

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

<syntaxhighlight lang="python3">
>>> 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})</syntaxhighlight>

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

* [[Python/Counter/elements|التابع <code>elements()‎</code>: ]] :يعيد هذا التابع كائنًا مكرِّرًا يتضمّن عناصر تتكرّر فيه حسب قيمة التعداد في كائن التعداد.
* [[Python/Counter/most_common|التابع <code>most_common()‎</code>: ]] :يعيد التابع قائمة بالعناصر الأكثر تكرارًا إلى جانب عدد مرات التكرار.

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


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