الدالة functools.tools.cmp_to_key()‎ في بايثون

من موسوعة حسوب
< Python‏ | functools
مراجعة 16:05، 19 يونيو 2018 بواسطة عبد-الهادي-الديوري (نقاش | مساهمات) (←‏أمثلة)
(فرق) → مراجعة أقدم | المراجعة الحالية (فرق) | مراجعة أحدث ← (فرق)
اذهب إلى التنقل اذهب إلى البحث

تُحوّل الدّالة functools.cmp_to_key()‎ دالّة مُقارنة (comparison function) إلى دالّة مفتاح (key function).

تُستعمل مع الأدوات التي تقبل دوالّ مفتاح مثل sorted()‎، وmin()‎، وmax()‎، وheapq.nlargest()‎، وheapq.nsmallest()‎، وitertools.groupby()‎.

تُستعمل هذه الدّالة أساسًا كأداة لنقل البرامج من Python 2 التي دعمت استعمال دوال المُقارنة.

دالّة المُقارنة هي كلّ كائن قابل للاستدعاء يستقبل مُعاملين ويُقارن بينهما، ويُعيد عددًا سالبًا في حالة أصغر من، الصّفر في حالة التّساوي، وعددًا موجبًا في حالة أكبر من. ودالّة مفتاح هي كائن قابل للاستدعاء يستقبل مُعاملًا واحدًا ويُعيد قيمةً أخرى لاستعمالها كمفتاح للتّرتيب.

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

functools.cmp_to_key(func)

المعاملات

func

دالّة المُقارنة المرغوب تحويلها لدالّة مفتاح.

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

دالّة مفتاح.

أمثلة

المثال التّالي يوضّح كيفيّة عمل هذه الدّالة:

>>> sorted('AKDE', key=functools.cmp_to_key(locale.strcoll)) # ترتيب يأخذ الموقع بعين الاعتبار
['A', 'D', 'E', 'K']

انظر أيضًا

مصادر