عرض مصدر Python/OrderedDict/move to end

<noinclude>{{DISPLAYTITLE:التابع <code>OrderedDict.move_to_end()‎</code> في بايثون}}</noinclude>

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

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

<syntaxhighlight lang="python3">
od.move_to_end(key, last=True)
</syntaxhighlight>

== المعاملات ==
=== <code>key</code> ===

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

=== <code>last</code> ===

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

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

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

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

== أمثلة ==

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

<syntaxhighlight lang="python3">
>>> d = OrderedDict.fromkeys('abcde')
>>> d.move_to_end('b')
>>> ''.join(d.keys())
'acdeb'
>>> d.move_to_end('b', last=False)
>>> ''.join(d.keys())
'bacde'

</syntaxhighlight>

== انظر أيضًا ==
* [[Python/OrderedDict/popitem|التابع <code>popitem()‎</code>]]: هذا التابع خاص بالقواميس المرتّبة ويحذف ويعيد زوج (مفتاح، قيمة) من القاموس المرتب.

== مصادر ==
[https://docs.python.org/3/library/collections.html#collections.OrderedDict.popitem قسم OrderedDict Objects في صفحة Container Datatypes في توثيق بايثون الرسمي.]

[[تصنيف:Python]]
[[تصنيف:Python Modules]]
[[تصنيف:Python Methods]]