التابع OrderedDict.move_to_end()‎ في بايثون

يحرّك التابع المفتاح المعطى إلى إحدى نهايتي القاموس المرتّب.

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

od.move_to_end(key, last=True)

المعاملات

key

المفتاح المراد تحريكه.

last

قيمة منطقية، تحدّد جهة تحريك المفتاح المحدّد. يُحرّك التابع العنصر المحدّد إلى الجهة اليمنى من القاموس (نهايته) إن أخذ المعامل last القيمة True (القيمة الافتراضية)، ويحرّكه إلى الجهة اليسرى من القاموس (بدايته) إن أخذ المعامل القيمة False.

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

يطلق التابع الاستثناء KeyError إن كان المفتاح المطلوب غير موجود.

ملاحظة: هذا التابع جديد في الإصدار 3.2 من بايثون.

أمثلة

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

>>> d = OrderedDict.fromkeys('abcde')
>>> d.move_to_end('b')
>>> ''.join(d.keys())
'acdeb'
>>> d.move_to_end('b', last=False)
>>> ''.join(d.keys())
'bacde'

انظر أيضًا

• التابع popitem()‎: هذا التابع خاص بالقواميس المرتّبة ويحذف ويعيد زوج (مفتاح، قيمة) من القاموس المرتب.

مصادر

قسم OrderedDict Objects في صفحة Container Datatypes في توثيق بايثون الرسمي.