Python/sorted

تعيد الدّالة sorted()‎ قائمةً مُرتّبةً من عناصر الكائن القابل للتّكرار المُعطى.

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

sorted(iterable, *, key=None, reverse=False)

المعاملات

iterable

الكائن القابل للتّكرار المُراد ترتيبُ عناصره.

key

مُعامل اختياريّ ومُعامل كلمة مفتاحيّة (keyword argument) يُحدّد دالّة تقبل مُعاملا واحدًا تُستعمل لأخذ مفتاح ترتيب من كلّ عنصر من عناصر القائمة، يُمكنك استعمال الدّالة ‎str‎.‎lower‎ كمفتاح مثلًا لترتيب الأحرف حسب صيغتها الصّغيرة (lowercase). القيمة الافتراضيّة هي القيمة None والتي تعني بأنّ المُقارنة ستُجرى على العناصر مُباشرةً.

reverse

مُعامل اختياريّ ومُعامل كلمة مفتاحيّة يكون قيمةً منطقيّةً تُحدّد ما إن كان التّرتيب النّهائي سيكون معكوسًا (عند تمرير القيمة True) أو لا (عند تمرير القيمة False أو ترك المُعامل دون تمرير أية قيمة له).

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

قائمة بعناصر الكائن القابل للتّكرار مُرتّبةً.

أمثلة

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

>>> sorted('acB') # ترتيب أبجدي يُقدّم الأحرف الكبيرة على الصّغيرة
['B', 'a', 'c']
>>> sorted('acB', key=str.lower) # ترتيب بغضّ النّظر عن حالة الأحرف
['a', 'B', 'c']
>>> sorted('213') # ترتيب عددي
['1', '2', '3']
>>> sorted(["Ahmed", "Ali", "A"]) # ترتيب قائمة أبجديًّا
['A', 'Ahmed', 'Ali']
>>> sorted(["Ahmed", "Ali", "A"], key=lambda x: len(x)) # ترتيب حسب طول العنصر
['A', 'Ali', 'Ahmed']
>>> sorted(["Ahmed", "Ali", "A"], key=lambda x: len(x), reverse=True) # عكس التّرتيب أعلاه
['Ahmed', 'Ali', 'A']

ملاحظات

• استعمل الدّالة functools.cmp_to_key لتحويل دالّة cmp قديمة إلى دالّة مفتاح يُمكنك استعمالها مع المُعامل key.
• الدّالة المُضمّنة sorted()‎ مُستقرّة دائمًا. تضمن الدّالة بأنّ التّرتيب لن يُغيِّر من التّرتيب النّسبي للعناصر المُتساوية، هذا مُفيد للترتيب على عدّة استدعاءات (التّرتيب حسب القسم ثمّ التّرتيب حسب درجة الرّاتب مثلًا).

انظر أيضًا

• تعابير lambda.
• functools.cmp_to_key.
• القوائم lists في بايثون.
• الترتيب في بايثون. لأمثلة ودرسٍ مُختصر في التّرتيب.

مصادر

• قسم الدالة sorted في صفحة Functions في توثيق Python الرسمي.