Python/functools/cmp to key

تُحوّل الدّالة 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']

انظر أيضًا

• الدالة min()‎ : الحصول على أصغر قيمة من عدّة قيّم.
• الدالة max()‎ : الحصول على أكبر قيمة من عدّة قيّم.
• الدّالة sorted()‎ : ترتيب القيم.
• الدالة itertools.groupby()‎: تجميع القيّم حسب مفتاح مُعيّن.
• الدالة heapq.nlargest.
• الدالة heapq.nsmallest.

مصادر

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