الفرق بين المراجعتين لصفحة: «Python/OrderedDict/move to end»

من موسوعة حسوب
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE:التابع <code>OrderedDict.move_to_end()‎</code> في بايثون}}</noinclude> يحرّك التابع المفتاح المعطى إ...'
 
لا ملخص تعديل
 
(1 مراجعات متوسطة بواسطة نفس المستخدم غير معروضة)
سطر 10: سطر 10:


== المعاملات ==
== المعاملات ==
=== <code>key</code> ===
المفتاح المراد تحريكه.
=== <code>last</code> ===
=== <code>last</code> ===


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


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


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


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


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


== مصادر ==
== مصادر ==

المراجعة الحالية بتاريخ 08:14، 3 أغسطس 2018


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

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

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 في توثيق بايثون الرسمي.