التابع deque.rotate()‎ في بايثون

يدوّر التابع عناصر كائن deque إلى جهة اليمين بعدد الخطوات المعطاة.

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

d.rotate(n=1)

المعاملات

n

عدد الخطوات التي سيدير بها التابع عناصر كائن deque. إن كان العدد موجبًا فإن التدوير يكون باتجاه اليمين، وإن كان العدد سالبًا فإن التدوير يكون باتجاه اليسار.

يأخذ هذا المعامل القيمة الافتراضية 1.

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

يعيد التابع كائن deque بعد إجراء عملية تدوير العناصر بحسب عدد الخطوات المعطاة.

عندما لا يكون كائن deque فارغًا، فإنّ عملية التدوير خطوة واحدة إلى اليمين تكون مكافئة للتعبير d.appendleft(d.pop())‎، وعملية التدوير خطوة واحدة إلى اليسار مكافئة للتعبير d.append(d.popleft())‎.

أمثلة

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

>>> from collections import deque
>>> d = deque('abcdefgh')
>>> d
deque(['a', 'b', 'c', 'd', 'e', 'f', 'g', 'h'])
>>> d.rotate()
>>> d
deque(['h', 'a', 'b', 'c', 'd', 'e', 'f', 'g'])
>>> d.rotate(-1)
>>> d
deque(['a', 'b', 'c', 'd', 'e', 'f', 'g', 'h'])
>>> d.rotate(3)
>>> d
deque(['f', 'g', 'h', 'a', 'b', 'c', 'd', 'e'])
>>> d.rotate(-2)
>>> d
deque(['h', 'a', 'b', 'c', 'd', 'e', 'f', 'g'])

مصادر

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