Python/itertools/starmap

تعيد الدّالة itertools.starmap()‎ مُكرّرًا يستدعي الدّالة باستخدام المُعاملات المُعطاة في الكائن القابل للتّكرار.

تُستعمل عوضًا عن الدالة map()‎ عندما تكون قيم المُعاملات مُجموعةً في صفّ في كائن واحد قابل للتّكرار (أي أنّ البيانات قد جُمِّعَت مُسبقًا).

الفرق بين الدالة map()‎ والدّالة itertools.starmap()‎ يُوازي الفرق بين الاستدعاء function(a,b)‎‎ والاستدعاء function(*c)‎‎.

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

itertools.starmap(function, iterable)

المعاملات

function

الدّالة المُراد استدعاؤها.

iterable

كائن قابل للتّكرار يحتوي على صفوف لتُمرّر إلى الدّالة كمُعاملات مُفكّكة.

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

مُكرّر يُعيد نتائج استدعاء الدّالة واحدة بواحدة.

أمثلة

المثال التّالي يوضّح كيفيّة عمل هذه الدّالة (انظر الدالة pow()‎):

>>> list(itertools.starmap(pow, [(2,5), (3,2), (10,3)]))
[32, 9, 1000]

ملاحظات

الدّالة مُكافئة لما يلي:

def starmap(function, iterable):
    # starmap(pow, [(2,5), (3,2), (10,3)]) --> 32 9 1000
    for args in iterable:
        yield function(*args)

انظر أيضًا

• المكرِّرات Iterators في بايثون.
• المولدات Generators في بايثون.
• الدالة map()‎: تُطبّق دالة على كلّ عنصر من عناصر الكائن القابل للتّكرار.
• الدالة pow()‎: تُطبّق دالة على كلّ عنصر من عناصر الكائن القابل للتّكرار.

مصادر

• قسم الدالة itertools.starmap في توثيق Python الرسمي.