عرض مصدر Python/reversed

<noinclude>{{DISPLAYTITLE:الدالة <code>reversed()‎</code> في بايثون}}</noinclude>
تعيد الدّالة <code>reversed()‎</code> مُكرّرًا معكوسًا يحتوي على كائن التّسلسل (sequence) المُعطى بالتّرتيب المُعاكس.

== البنية العامة ==
<syntaxhighlight lang="python3">
reversed(seq)
</syntaxhighlight>

== المعاملات ==
=== <code>seq</code> ===
تسلسل القيم المرغوب الحصول على مُكرّر مُعاكس لها.

يجب أن تكون قيمة المُعامل كائنًا يمتلك صنفه التّابع الخاصّ <code>‎_‎_‎reversed‎_‎_‎(‎)‎</code> أو أن يدعم بروتوكول التّسلسل (أي أن يحتوي صنفه على التّابع <code>‎_‎_‎len‎_‎_‎(‎)‎</code> والتّابع <code>‎_‎_‎getitem‎_‎_‎(‎)‎</code> مع مُعاملات أعداد صحيحة تبدأ من الصّفر).

== القيمة المعادة ==
مُكرّر تكون عناصره نتيجة عكس ترتيب العناصر المُعطاة.

== أمثلة ==
المثال التّالي يوضّح كيفيّة عمل هذه الدّالة، لاحظ أنّنا نُحوّل المُكرّر إلى قائمة لتظهر عناصره:
<syntaxhighlight lang="python3">
>>> list(reversed([1, 2, 3])) # عكس عناصر قائمة
[3, 2, 1]
>>> list(reversed('ABCD')) # عكس عناصر سلسلة نصيّة
['D', 'C', 'B', 'A']
</syntaxhighlight>

== انظر أيضًا ==
* [[Python/int|الأعداد الصحيحة في بايثون]].
* [[Python/iterators|المكرِّرات Iterators في بايثون]].

== مصادر ==
* [https://docs.python.org/3/library/functions.html#reversed قسم الدالة reversed في صفحة Functions في توثيق Python الرسمي].
[[تصنيف:Python]]
[[تصنيف:Python Function]]
[[تصنيف:Python Built-in Functions]]