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

<noinclude>{{DISPLAYTITLE:التابع <code>Counter.update()‎</code> في بايثون}}</noinclude>

هذا التابع مشابه للتابع <code>[[Python/dict/update|dict.update()]]</code>‎ ولكنّه يضيف التعدادات بدلًا من استبدالها.

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

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

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

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

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

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

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

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

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

هذا التابع مشابه للتابع <code>[[Python/dict/update|dict.update()]]</code>‎ ولكنّه يضيف التعدادات بدلًا من استبدالها، إلى جانب أنّه يجب أن يكون الكائن المكرِّر تسلسلًا من العناصر وليس تسلسلًا من أزواج (مفتاح، قيمة). 

== أمثلة ==

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

<syntaxhighlight lang="python3">
import collections

c = collections.Counter()
print ('Initial: ', c)

c.update('abcdaab')
print ('Sequence: ', c)

c.update({'a':1, 'd':5})
print ('Dict: ', c)
</syntaxhighlight>

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

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

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

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