CKTIS / Python
collections.deque
Управлява опашка с добавяне и премахване от двата края за приблизително постоянно време.
Версия: Python 3.14; repository image, production runtime not attested
Синтаксис
collections.deque(iterable=(), maxlen=None)Управлява опашка с добавяне и премахване от двата края за приблизително постоянно време.
Всяко отделно добавяне или премахване от краищата е безопасно между нишки, но последователност от такива операции няма обща защита. При пълна опашка insert поражда IndexError без изместване, а при maxlen=0 опашката винаги е празна. append и pop работят отдясно, а appendleft и popleft отляво. При достигната дължина maxlen нов елемент измества елемента от противоположния край. Премахване от празна опашка поражда IndexError.
В примера 5 измества 2, а след това 1, добавено отляво, измества 5.
from collections import deque
d = deque([1, 2], maxlen=2)
d.appendleft(0)
assert list(d) == [0, 1] and d.pop() == 1
d.clear()
try:
d.popleft()
except IndexError:
pass
else:
raise AssertionError
z = deque(maxlen=0)
z.append(1)
assert list(z) == []
d = deque([1], maxlen=1)
try:
d.insert(0, 2)
except IndexError:
assert list(d) == [1]
else:
raise AssertionError
collections.deque.append · collections.deque.pop · collections.deque.popleft
append(x) добавя отдясно и при пълен maxlen премахва левия елемент. pop() премахва и връща десния, а popleft() левия. И двата метода предизвикват IndexError при празна опашка.
from collections import deque
q = deque([1, 2], maxlen=2)
assert q.append(3) is None and list(q) == [2, 3]
assert q.popleft() == 2 and q.pop() == 3
for remove in (q.pop, q.popleft):
try: remove()
except IndexError: pass
else: raise AssertionError
Примери
import collections
q = collections.deque([2, 3], maxlen=2)
q.append(5)
print(list(q))
q.appendleft(1)
print(list(q))
Резултат
[3, 5] [1, 3]
В примера 5 измества 2, а след това 1, добавено отляво, измества 5.