appendleft() method of deque class in Python

appendleft() adds an element to the left side of a deque object. When fixed size deques are involved when adding an element on the left removes an element on the right

Deque Updated 19 Mar 2017 1 min read

Method Name

appendleft

Method Signature

appendleft()

Method Overview

  • The appendleft() method adds an element to the left side of the deque object.
  • On a deque object with fixed length when an element is added at the left side, an element is removed at the right side.

Appending an object to the left of a deque

Example 1

python
import collections

writerDeque = collections.deque()

print("Contents of writerDeque as writers are added to left:")

writerDeque.appendleft("Pen")

print(writerDeque)

writerDeque.appendleft("Pencil")

print(writerDeque)

writerDeque.appendleft("Marker")

print(writerDeque)

Output

Output
Contents of writerDeque as writers are added to left:

deque(['Pen'])

deque(['Pencil', 'Pen'])

deque(['Marker', 'Pencil', 'Pen'])

Example 2

python
import collections

numberDeque = collections.deque(maxlen=3)

print("Contents of numberDeque as numbers are added to left:")

numberDeque.appendleft(1)

print(numberDeque)

numberDeque.appendleft(2)

print(numberDeque)

numberDeque.appendleft(3)

print(numberDeque)

print("Deque size:%d"%(len(numberDeque)))

# When the deque has reached maximum length

print("Adding after deque has reached maximum length")

numberDeque.appendleft(3)

print(numberDeque)

print("Deque size:%d"%(len(numberDeque)))

Output

Output
Contents of numberDeque as numbers are added to left:

deque([1], maxlen=3)

deque([2, 1], maxlen=3)

deque([3, 2, 1], maxlen=3)

Deque size:3

Adding after deque has reached maximum length

deque([3, 3, 2], maxlen=3)

Deque size:3