コンテンツにスキップ

5.2   キュー

キュー(queue)は、先入れ先出しの規則に従う線形データ構造です。名前のとおり、キューは順番待ちの現象を模したもので、新しく来た人は絶えずキュー末尾に加わり、キュー先頭にいる人から順に離れていきます。

下図のように、キューの先頭を「キュー先頭」、末尾を「キュー末尾」と呼びます。要素をキュー末尾に加える操作を「エンキュー」、キュー先頭の要素を削除する操作を「デキュー」と呼びます。

キューの先入れ先出し規則

図 5-4   キューの先入れ先出し規則

5.2.1   キューの基本操作

キューの基本操作を以下の表に示します。なお、メソッド名はプログラミング言語によって異なる場合があります。ここではスタックと同じ命名を採用します。

表 5-2   キュー操作の効率

メソッド名 説明 時間計算量
push() 要素をエンキューし、キュー末尾に追加する \(O(1)\)
pop() キュー先頭の要素をデキューする \(O(1)\)
peek() キュー先頭の要素にアクセスする \(O(1)\)

プログラミング言語に用意された既存のキュークラスをそのまま利用できます:

queue.py
from collections import deque

# キューを初期化
# Python では、通常は双方向キュークラス deque をキューとして使用する
# queue.Queue() は純粋なキュークラスだが、やや使いにくいため非推奨
que: deque[int] = deque()

# 要素をエンキュー
que.append(1)
que.append(3)
que.append(2)
que.append(5)
que.append(4)

# キュー先頭の要素にアクセス
front: int = que[0]

# 要素をデキュー
pop: int = que.popleft()

# キューの長さを取得
size: int = len(que)

# キューが空かどうかを判定
is_empty: bool = len(que) == 0
queue.cpp
/* キューを初期化 */
queue<int> queue;

/* 要素をエンキュー */
queue.push(1);
queue.push(3);
queue.push(2);
queue.push(5);
queue.push(4);

/* キュー先頭の要素にアクセス */
int front = queue.front();

/* 要素をデキュー */
queue.pop();

/* キューの長さを取得 */
int size = queue.size();

/* キューが空かどうかを判定 */
bool empty = queue.empty();
queue.java
/* キューを初期化 */
Queue<Integer> queue = new LinkedList<>();

/* 要素をエンキュー */
queue.offer(1);
queue.offer(3);
queue.offer(2);
queue.offer(5);
queue.offer(4);

/* キュー先頭の要素にアクセス */
int peek = queue.peek();

/* 要素をデキュー */
int pop = queue.poll();

/* キューの長さを取得 */
int size = queue.size();

/* キューが空かどうかを判定 */
boolean isEmpty = queue.isEmpty();
queue.cs
/* キューを初期化 */
Queue<int> queue = new();

/* 要素をエンキュー */
queue.Enqueue(1);
queue.Enqueue(3);
queue.Enqueue(2);
queue.Enqueue(5);
queue.Enqueue(4);

/* キュー先頭の要素にアクセス */
int peek = queue.Peek();

/* 要素をデキュー */
int pop = queue.Dequeue();

/* キューの長さを取得 */
int size = queue.Count;

/* キューが空かどうかを判定 */
bool isEmpty = queue.Count == 0;
queue_test.go
/* キューを初期化 */
// Go では、list をキューとして使用する
queue := list.New()

/* 要素をエンキュー */
queue.PushBack(1)
queue.PushBack(3)
queue.PushBack(2)
queue.PushBack(5)
queue.PushBack(4)

/* キュー先頭の要素にアクセス */
peek := queue.Front()

/* 要素をデキュー */
pop := queue.Front()
queue.Remove(pop)

/* キューの長さを取得 */
size := queue.Len()

/* キューが空かどうかを判定 */
isEmpty := queue.Len() == 0
queue.swift
/* キューを初期化 */
// Swift には組み込みのキュークラスがないため、Array をキューとして使える
var queue: [Int] = []

/* 要素をエンキュー */
queue.append(1)
queue.append(3)
queue.append(2)
queue.append(5)
queue.append(4)

/* キュー先頭の要素にアクセス */
let peek = queue.first!

/* 要素をデキュー */
// 配列であるため、removeFirst の計算量は O(n)
let pool = queue.removeFirst()

/* キューの長さを取得 */
let size = queue.count

/* キューが空かどうかを判定 */
let isEmpty = queue.isEmpty
queue.js
/* キューを初期化 */
// JavaScript には組み込みのキューがないため、Array をキューとして使える
const queue = [];

/* 要素をエンキュー */
queue.push(1);
queue.push(3);
queue.push(2);
queue.push(5);
queue.push(4);

/* キュー先頭の要素にアクセス */
const peek = queue[0];

/* 要素をデキュー */
// 基盤は配列であるため、shift() メソッドの時間計算量は O(n)
const pop = queue.shift();

/* キューの長さを取得 */
const size = queue.length;

/* キューが空かどうかを判定 */
const empty = queue.length === 0;
queue.ts
/* キューを初期化 */
// TypeScript には組み込みのキューがないため、Array をキューとして使える
const queue: number[] = [];

/* 要素をエンキュー */
queue.push(1);
queue.push(3);
queue.push(2);
queue.push(5);
queue.push(4);

/* キュー先頭の要素にアクセス */
const peek = queue[0];

/* 要素をデキュー */
// 基盤は配列であるため、shift() メソッドの時間計算量は O(n)
const pop = queue.shift();

/* キューの長さを取得 */
const size = queue.length;

/* キューが空かどうかを判定 */
const empty = queue.length === 0;
queue.dart
/* キューを初期化 */
// Dart では、キュークラス Qeque は双方向キューであり、キューとしても使用できる
Queue<int> queue = Queue();

/* 要素をエンキュー */
queue.add(1);
queue.add(3);
queue.add(2);
queue.add(5);
queue.add(4);

/* キュー先頭の要素にアクセス */
int peek = queue.first;

/* 要素をデキュー */
int pop = queue.removeFirst();

/* キューの長さを取得 */
int size = queue.length;

/* キューが空かどうかを判定 */
bool isEmpty = queue.isEmpty;
queue.rs
/* 双方向キューを初期化 */
// Rust では双方向キューを通常のキューとして使う
let mut deque: VecDeque<u32> = VecDeque::new();

/* 要素をエンキュー */
deque.push_back(1);
deque.push_back(3);
deque.push_back(2);
deque.push_back(5);
deque.push_back(4);

/* キュー先頭の要素にアクセス */
if let Some(front) = deque.front() {
}

/* 要素をデキュー */
if let Some(pop) = deque.pop_front() {
}

/* キューの長さを取得 */
let size = deque.len();

/* キューが空かどうかを判定 */
let is_empty = deque.is_empty();
queue.c
// C には組み込みのキューがない
queue.kt
/* キューを初期化 */
val queue = LinkedList<Int>()

/* 要素をエンキュー */
queue.offer(1)
queue.offer(3)
queue.offer(2)
queue.offer(5)
queue.offer(4)

/* キュー先頭の要素にアクセス */
val peek = queue.peek()

/* 要素をデキュー */
val pop = queue.poll()

/* キューの長さを取得 */
val size = queue.size

/* キューが空かどうかを判定 */
val isEmpty = queue.isEmpty()
queue.rb
# キューを初期化
# Ruby 組み込みのキュー(Thread::Queue) には peek と走査メソッドがないため、Array をキューとして使える
queue = []

# 要素をエンキュー
queue.push(1)
queue.push(3)
queue.push(2)
queue.push(5)
queue.push(4)

# キュー先頭の要素にアクセス
peek = queue.first

# 要素をデキュー
# 注意:配列であるため、Array#shift メソッドの時間計算量は O(n)
pop = queue.shift

# キューの長さを取得
size = queue.length

# キューが空かどうかを判定
is_empty = queue.empty?
可視化実行

https://pythontutor.com/render.html#code=from%20collections%20import%20deque%0A%0A%22%22%22Driver%20Code%22%22%22%0Aif%20__name__%20%3D%3D%20%22__main__%22%3A%0A%20%20%20%20%23%20%E5%88%9D%E5%A7%8B%E5%8C%96%E9%98%9F%E5%88%97%0A%20%20%20%20%23%20%E5%9C%A8%20Python%20%E4%B8%AD%EF%BC%8C%E6%88%91%E4%BB%AC%E4%B8%80%E8%88%AC%E5%B0%86%E5%8F%8C%E5%90%91%E9%98%9F%E5%88%97%E7%B1%BB%20deque%20%E7%9C%8B%E4%BD%9C%E9%98%9F%E5%88%97%E4%BD%BF%E7%94%A8%0A%20%20%20%20%23%20%E8%99%BD%E7%84%B6%20queue.Queue%28%29%20%E6%98%AF%E7%BA%AF%E6%AD%A3%E7%9A%84%E9%98%9F%E5%88%97%E7%B1%BB%EF%BC%8C%E4%BD%86%E4%B8%8D%E5%A4%AA%E5%A5%BD%E7%94%A8%0A%20%20%20%20que%20%3D%20deque%28%29%0A%0A%20%20%20%20%23%20%E5%85%83%E7%B4%A0%E5%85%A5%E9%98%9F%0A%20%20%20%20que.append%281%29%0A%20%20%20%20que.append%283%29%0A%20%20%20%20que.append%282%29%0A%20%20%20%20que.append%285%29%0A%20%20%20%20que.append%284%29%0A%20%20%20%20print%28%22%E9%98%9F%E5%88%97%20que%20%3D%22,%20que%29%0A%0A%20%20%20%20%23%20%E8%AE%BF%E9%97%AE%E9%98%9F%E9%A6%96%E5%85%83%E7%B4%A0%0A%20%20%20%20front%20%3D%20que%5B0%5D%0A%20%20%20%20print%28%22%E9%98%9F%E9%A6%96%E5%85%83%E7%B4%A0%20front%20%3D%22,%20front%29%0A%0A%20%20%20%20%23%20%E5%85%83%E7%B4%A0%E5%87%BA%E9%98%9F%0A%20%20%20%20pop%20%3D%20que.popleft%28%29%0A%20%20%20%20print%28%22%E5%87%BA%E9%98%9F%E5%85%83%E7%B4%A0%20pop%20%3D%22,%20pop%29%0A%20%20%20%20print%28%22%E5%87%BA%E9%98%9F%E5%90%8E%20que%20%3D%22,%20que%29%0A%0A%20%20%20%20%23%20%E8%8E%B7%E5%8F%96%E9%98%9F%E5%88%97%E7%9A%84%E9%95%BF%E5%BA%A6%0A%20%20%20%20size%20%3D%20len%28que%29%0A%20%20%20%20print%28%22%E9%98%9F%E5%88%97%E9%95%BF%E5%BA%A6%20size%20%3D%22,%20size%29%0A%0A%20%20%20%20%23%20%E5%88%A4%E6%96%AD%E9%98%9F%E5%88%97%E6%98%AF%E5%90%A6%E4%B8%BA%E7%A9%BA%0A%20%20%20%20is_empty%20%3D%20len%28que%29%20%3D%3D%200%0A%20%20%20%20print%28%22%E9%98%9F%E5%88%97%E6%98%AF%E5%90%A6%E4%B8%BA%E7%A9%BA%20%3D%22,%20is_empty%29&cumulative=false&curInstr=3&heapPrimitives=nevernest&mode=display&origin=opt-frontend.js&py=311&rawInputLstJSON=%5B%5D&textReferences=false

5.2.2   キューの実装

キューを実装するには、一方の端で要素を追加し、もう一方の端で要素を削除できるデータ構造が必要です。連結リストと配列はいずれもこの条件を満たします。

1.   連結リストに基づく実装

下図のように、連結リストの「先頭ノード」と「末尾ノード」をそれぞれ「キュー先頭」と「キュー末尾」とみなし、キュー末尾ではノードの追加のみ、キュー先頭ではノードの削除のみを行うようにします。

連結リストでキューを実装したエンキューとデキュー操作

linkedlist_queue_push

linkedlist_queue_pop

図 5-5   連結リストでキューを実装したエンキューとデキュー操作

以下は連結リストでキューを実装するコードです:

linkedlist_queue.py
class LinkedListQueue:
    """連結リストベースのキュー"""

    def __init__(self):
        """コンストラクタ"""
        self._front: ListNode | None = None  # 先頭ノード front
        self._rear: ListNode | None = None  # 末尾ノード rear
        self._size: int = 0

    def size(self) -> int:
        """キューの長さを取得"""
        return self._size

    def is_empty(self) -> bool:
        """キューが空かどうかを判定"""
        return self._size == 0

    def push(self, num: int):
        """エンキュー"""
        # 末尾ノードの後ろに num を追加
        node = ListNode(num)
        # キューが空なら、先頭・末尾ノードをともにそのノードに設定
        if self._front is None:
            self._front = node
            self._rear = node
        # キューが空でなければ、そのノードを末尾ノードの後ろに追加
        else:
            self._rear.next = node
            self._rear = node
        self._size += 1

    def pop(self) -> int:
        """デキュー"""
        num = self.peek()
        # 先頭ノードを削除
        self._front = self._front.next
        self._size -= 1
        return num

    def peek(self) -> int:
        """キュー先頭の要素にアクセス"""
        if self.is_empty():
            raise IndexError("キューが空です")
        return self._front.val

    def to_list(self) -> list[int]:
        """表示用にリストへ変換"""
        queue = []
        temp = self._front
        while temp:
            queue.append(temp.val)
            temp = temp.next
        return queue
linkedlist_queue.cpp
/* 連結リストベースのキュー */
class LinkedListQueue {
  private:
    ListNode *front, *rear; // 先頭ノード front、末尾ノード rear
    int queSize;

  public:
    LinkedListQueue() {
        front = nullptr;
        rear = nullptr;
        queSize = 0;
    }

    ~LinkedListQueue() {
        // 連結リストを走査してノードを削除し、メモリを解放する
        freeMemoryLinkedList(front);
    }

    /* キューの長さを取得 */
    int size() {
        return queSize;
    }

    /* キューが空かどうかを判定 */
    bool isEmpty() {
        return queSize == 0;
    }

    /* エンキュー */
    void push(int num) {
        // 末尾ノードの後ろに num を追加
        ListNode *node = new ListNode(num);
        // キューが空なら、先頭・末尾ノードをともにそのノードに設定
        if (front == nullptr) {
            front = node;
            rear = node;
        }
        // キューが空でなければ、そのノードを末尾ノードの後ろに追加
        else {
            rear->next = node;
            rear = node;
        }
        queSize++;
    }

    /* デキュー */
    int pop() {
        int num = peek();
        // 先頭ノードを削除
        ListNode *tmp = front;
        front = front->next;
        // メモリを解放する
        delete tmp;
        queSize--;
        return num;
    }

    /* キュー先頭の要素にアクセス */
    int peek() {
        if (size() == 0)
            throw out_of_range("キューが空です");
        return front->val;
    }

    /* 連結リストを Vector に変換して返す */
    vector<int> toVector() {
        ListNode *node = front;
        vector<int> res(size());
        for (int i = 0; i < res.size(); i++) {
            res[i] = node->val;
            node = node->next;
        }
        return res;
    }
};
linkedlist_queue.java
/* 連結リストベースのキュー */
class LinkedListQueue {
    private ListNode front, rear; // 先頭ノード front、末尾ノード rear
    private int queSize = 0;

    public LinkedListQueue() {
        front = null;
        rear = null;
    }

    /* キューの長さを取得 */
    public int size() {
        return queSize;
    }

    /* キューが空かどうかを判定 */
    public boolean isEmpty() {
        return size() == 0;
    }

    /* エンキュー */
    public void push(int num) {
        // 末尾ノードの後ろに num を追加
        ListNode node = new ListNode(num);
        // キューが空なら、先頭・末尾ノードをともにそのノードに設定
        if (front == null) {
            front = node;
            rear = node;
        // キューが空でなければ、そのノードを末尾ノードの後ろに追加
        } else {
            rear.next = node;
            rear = node;
        }
        queSize++;
    }

    /* デキュー */
    public int pop() {
        int num = peek();
        // 先頭ノードを削除
        front = front.next;
        queSize--;
        return num;
    }

    /* キュー先頭の要素にアクセス */
    public int peek() {
        if (isEmpty())
            throw new IndexOutOfBoundsException();
        return front.val;
    }

    /* 連結リストを Array に変換して返す */
    public int[] toArray() {
        ListNode node = front;
        int[] res = new int[size()];
        for (int i = 0; i < res.length; i++) {
            res[i] = node.val;
            node = node.next;
        }
        return res;
    }
}
linkedlist_queue.cs
/* 連結リストベースのキュー */
class LinkedListQueue {
    ListNode? front, rear;  // 先頭ノード front、末尾ノード rear
    int queSize = 0;

    public LinkedListQueue() {
        front = null;
        rear = null;
    }

    /* キューの長さを取得 */
    public int Size() {
        return queSize;
    }

    /* キューが空かどうかを判定 */
    public bool IsEmpty() {
        return Size() == 0;
    }

    /* エンキュー */
    public void Push(int num) {
        // 末尾ノードの後ろに num を追加
        ListNode node = new(num);
        // キューが空なら、先頭・末尾ノードをともにそのノードに設定
        if (front == null) {
            front = node;
            rear = node;
            // キューが空でなければ、そのノードを末尾ノードの後ろに追加
        } else if (rear != null) {
            rear.next = node;
            rear = node;
        }
        queSize++;
    }

    /* デキュー */
    public int Pop() {
        int num = Peek();
        // 先頭ノードを削除
        front = front?.next;
        queSize--;
        return num;
    }

    /* キュー先頭の要素にアクセス */
    public int Peek() {
        if (IsEmpty())
            throw new Exception();
        return front!.val;
    }

    /* 連結リストを Array に変換して返す */
    public int[] ToArray() {
        if (front == null)
            return [];

        ListNode? node = front;
        int[] res = new int[Size()];
        for (int i = 0; i < res.Length; i++) {
            res[i] = node!.val;
            node = node.next;
        }
        return res;
    }
}
linkedlist_queue.go
/* 連結リストベースのキュー */
type linkedListQueue struct {
    // 組み込みパッケージ list でキューを実装する
    data *list.List
}

/* キューを初期化 */
func newLinkedListQueue() *linkedListQueue {
    return &linkedListQueue{
        data: list.New(),
    }
}

/* エンキュー */
func (s *linkedListQueue) push(value any) {
    s.data.PushBack(value)
}

/* デキュー */
func (s *linkedListQueue) pop() any {
    if s.isEmpty() {
        return nil
    }
    e := s.data.Front()
    s.data.Remove(e)
    return e.Value
}

/* キュー先頭の要素にアクセス */
func (s *linkedListQueue) peek() any {
    if s.isEmpty() {
        return nil
    }
    e := s.data.Front()
    return e.Value
}

/* キューの長さを取得 */
func (s *linkedListQueue) size() int {
    return s.data.Len()
}

/* キューが空かどうかを判定 */
func (s *linkedListQueue) isEmpty() bool {
    return s.data.Len() == 0
}

/* 表示用に List を取得 */
func (s *linkedListQueue) toList() *list.List {
    return s.data
}
linkedlist_queue.swift
/* 連結リストベースのキュー */
class LinkedListQueue {
    private var front: ListNode? // 先頭ノード
    private var rear: ListNode? // 末尾ノード
    private var _size: Int

    init() {
        _size = 0
    }

    /* キューの長さを取得 */
    func size() -> Int {
        _size
    }

    /* キューが空かどうかを判定 */
    func isEmpty() -> Bool {
        size() == 0
    }

    /* エンキュー */
    func push(num: Int) {
        // 末尾ノードの後ろに num を追加
        let node = ListNode(x: num)
        // キューが空なら、先頭・末尾ノードをともにそのノードに設定
        if front == nil {
            front = node
            rear = node
        }
        // キューが空でなければ、そのノードを末尾ノードの後ろに追加
        else {
            rear?.next = node
            rear = node
        }
        _size += 1
    }

    /* デキュー */
    @discardableResult
    func pop() -> Int {
        let num = peek()
        // 先頭ノードを削除
        front = front?.next
        _size -= 1
        return num
    }

    /* キュー先頭の要素にアクセス */
    func peek() -> Int {
        if isEmpty() {
            fatalError("キューが空です")
        }
        return front!.val
    }

    /* 連結リストを Array に変換して返す */
    func toArray() -> [Int] {
        var node = front
        var res = Array(repeating: 0, count: size())
        for i in res.indices {
            res[i] = node!.val
            node = node?.next
        }
        return res
    }
}
linkedlist_queue.js
/* 連結リストベースのキュー */
class LinkedListQueue {
    #front; // 先頭ノード #front
    #rear; // 末尾ノード #rear
    #queSize = 0;

    constructor() {
        this.#front = null;
        this.#rear = null;
    }

    /* キューの長さを取得 */
    get size() {
        return this.#queSize;
    }

    /* キューが空かどうかを判定 */
    isEmpty() {
        return this.size === 0;
    }

    /* エンキュー */
    push(num) {
        // 末尾ノードの後ろに num を追加
        const node = new ListNode(num);
        // キューが空なら、先頭・末尾ノードをともにそのノードに設定
        if (!this.#front) {
            this.#front = node;
            this.#rear = node;
            // キューが空でなければ、そのノードを末尾ノードの後ろに追加
        } else {
            this.#rear.next = node;
            this.#rear = node;
        }
        this.#queSize++;
    }

    /* デキュー */
    pop() {
        const num = this.peek();
        // 先頭ノードを削除
        this.#front = this.#front.next;
        this.#queSize--;
        return num;
    }

    /* キュー先頭の要素にアクセス */
    peek() {
        if (this.size === 0) throw new Error('キューが空');
        return this.#front.val;
    }

    /* 連結リストを Array に変換して返す */
    toArray() {
        let node = this.#front;
        const res = new Array(this.size);
        for (let i = 0; i < res.length; i++) {
            res[i] = node.val;
            node = node.next;
        }
        return res;
    }
}
linkedlist_queue.ts
/* 連結リストベースのキュー */
class LinkedListQueue {
    private front: ListNode | null; // 先頭ノード front
    private rear: ListNode | null; // 末尾ノード rear
    private queSize: number = 0;

    constructor() {
        this.front = null;
        this.rear = null;
    }

    /* キューの長さを取得 */
    get size(): number {
        return this.queSize;
    }

    /* キューが空かどうかを判定 */
    isEmpty(): boolean {
        return this.size === 0;
    }

    /* エンキュー */
    push(num: number): void {
        // 末尾ノードの後ろに num を追加
        const node = new ListNode(num);
        // キューが空なら、先頭・末尾ノードをともにそのノードに設定
        if (!this.front) {
            this.front = node;
            this.rear = node;
            // キューが空でなければ、そのノードを末尾ノードの後ろに追加
        } else {
            this.rear!.next = node;
            this.rear = node;
        }
        this.queSize++;
    }

    /* デキュー */
    pop(): number {
        const num = this.peek();
        if (!this.front) throw new Error('キューが空です');
        // 先頭ノードを削除
        this.front = this.front.next;
        this.queSize--;
        return num;
    }

    /* キュー先頭の要素にアクセス */
    peek(): number {
        if (this.size === 0) throw new Error('キューが空です');
        return this.front!.val;
    }

    /* 連結リストを Array に変換して返す */
    toArray(): number[] {
        let node = this.front;
        const res = new Array<number>(this.size);
        for (let i = 0; i < res.length; i++) {
            res[i] = node!.val;
            node = node!.next;
        }
        return res;
    }
}
linkedlist_queue.dart
/* 連結リストベースのキュー */
class LinkedListQueue {
  ListNode? _front; // 先頭ノード _front
  ListNode? _rear; // 末尾ノード _rear
  int _queSize = 0; // キューの長さ

  LinkedListQueue() {
    _front = null;
    _rear = null;
  }

  /* キューの長さを取得 */
  int size() {
    return _queSize;
  }

  /* キューが空かどうかを判定 */
  bool isEmpty() {
    return _queSize == 0;
  }

  /* エンキュー */
  void push(int _num) {
    // 末尾ノードの後ろに _num を追加
    final node = ListNode(_num);
    // キューが空なら、先頭・末尾ノードをともにそのノードに設定
    if (_front == null) {
      _front = node;
      _rear = node;
    } else {
      // キューが空でなければ、そのノードを末尾ノードの後ろに追加
      _rear!.next = node;
      _rear = node;
    }
    _queSize++;
  }

  /* デキュー */
  int pop() {
    final int _num = peek();
    // 先頭ノードを削除
    _front = _front!.next;
    _queSize--;
    return _num;
  }

  /* キュー先頭の要素にアクセス */
  int peek() {
    if (_queSize == 0) {
      throw Exception('キューが空です');
    }
    return _front!.val;
  }

  /* 連結リストを Array に変換して返す */
  List<int> toArray() {
    ListNode? node = _front;
    final List<int> queue = [];
    while (node != null) {
      queue.add(node.val);
      node = node.next;
    }
    return queue;
  }
}
linkedlist_queue.rs
/* 連結リストベースのキュー */
#[allow(dead_code)]
pub struct LinkedListQueue<T> {
    front: Option<Rc<RefCell<ListNode<T>>>>, // 先頭ノード front
    rear: Option<Rc<RefCell<ListNode<T>>>>,  // 末尾ノード rear
    que_size: usize,                         // キューの長さ
}

impl<T: Copy> LinkedListQueue<T> {
    pub fn new() -> Self {
        Self {
            front: None,
            rear: None,
            que_size: 0,
        }
    }

    /* キューの長さを取得 */
    pub fn size(&self) -> usize {
        return self.que_size;
    }

    /* キューが空かどうかを判定 */
    pub fn is_empty(&self) -> bool {
        return self.que_size == 0;
    }

    /* エンキュー */
    pub fn push(&mut self, num: T) {
        // 末尾ノードの後ろに num を追加
        let new_rear = ListNode::new(num);
        match self.rear.take() {
            // キューが空でなければ、そのノードを末尾ノードの後ろに追加
            Some(old_rear) => {
                old_rear.borrow_mut().next = Some(new_rear.clone());
                self.rear = Some(new_rear);
            }
            // キューが空なら、先頭・末尾ノードをともにそのノードに設定
            None => {
                self.front = Some(new_rear.clone());
                self.rear = Some(new_rear);
            }
        }
        self.que_size += 1;
    }

    /* デキュー */
    pub fn pop(&mut self) -> Option<T> {
        self.front.take().map(|old_front| {
            match old_front.borrow_mut().next.take() {
                Some(new_front) => {
                    self.front = Some(new_front);
                }
                None => {
                    self.rear.take();
                }
            }
            self.que_size -= 1;
            old_front.borrow().val
        })
    }

    /* キュー先頭の要素にアクセス */
    pub fn peek(&self) -> Option<&Rc<RefCell<ListNode<T>>>> {
        self.front.as_ref()
    }

    /* 連結リストを Array に変換して返す */
    pub fn to_array(&self, head: Option<&Rc<RefCell<ListNode<T>>>>) -> Vec<T> {
        let mut res: Vec<T> = Vec::new();

        fn recur<T: Copy>(cur: Option<&Rc<RefCell<ListNode<T>>>>, res: &mut Vec<T>) {
            if let Some(cur) = cur {
                res.push(cur.borrow().val);
                recur(cur.borrow().next.as_ref(), res);
            }
        }

        recur(head, &mut res);

        res
    }
}
linkedlist_queue.c
/* 連結リストベースのキュー */
typedef struct {
    ListNode *front, *rear;
    int queSize;
} LinkedListQueue;

/* コンストラクタ */
LinkedListQueue *newLinkedListQueue() {
    LinkedListQueue *queue = (LinkedListQueue *)malloc(sizeof(LinkedListQueue));
    queue->front = NULL;
    queue->rear = NULL;
    queue->queSize = 0;
    return queue;
}

/* デストラクタ */
void delLinkedListQueue(LinkedListQueue *queue) {
    // すべてのノードを解放
    while (queue->front != NULL) {
        ListNode *tmp = queue->front;
        queue->front = queue->front->next;
        free(tmp);
    }
    // queue 構造体を解放する
    free(queue);
}

/* キューの長さを取得 */
int size(LinkedListQueue *queue) {
    return queue->queSize;
}

/* キューが空かどうかを判定 */
bool empty(LinkedListQueue *queue) {
    return (size(queue) == 0);
}

/* エンキュー */
void push(LinkedListQueue *queue, int num) {
    // 末尾ノードに node を追加
    ListNode *node = newListNode(num);
    // キューが空なら、先頭・末尾ノードをともにそのノードに設定
    if (queue->front == NULL) {
        queue->front = node;
        queue->rear = node;
    }
    // キューが空でなければ、そのノードを末尾ノードの後ろに追加
    else {
        queue->rear->next = node;
        queue->rear = node;
    }
    queue->queSize++;
}

/* キュー先頭の要素にアクセス */
int peek(LinkedListQueue *queue) {
    assert(size(queue) && queue->front);
    return queue->front->val;
}

/* デキュー */
int pop(LinkedListQueue *queue) {
    int num = peek(queue);
    ListNode *tmp = queue->front;
    queue->front = queue->front->next;
    free(tmp);
    queue->queSize--;
    return num;
}

/* キューを出力する */
void printLinkedListQueue(LinkedListQueue *queue) {
    int *arr = malloc(sizeof(int) * queue->queSize);
    // 連結リスト内のデータを配列にコピー
    int i;
    ListNode *node;
    for (i = 0, node = queue->front; i < queue->queSize; i++) {
        arr[i] = node->val;
        node = node->next;
    }
    printArray(arr, queue->queSize);
    free(arr);
}
linkedlist_queue.kt
/* 連結リストベースのキュー */
class LinkedListQueue(
    // 先頭ノード front、末尾ノード rear
    private var front: ListNode? = null,
    private var rear: ListNode? = null,
    private var queSize: Int = 0
) {

    /* キューの長さを取得 */
    fun size(): Int {
        return queSize
    }

    /* キューが空かどうかを判定 */
    fun isEmpty(): Boolean {
        return size() == 0
    }

    /* エンキュー */
    fun push(num: Int) {
        // 末尾ノードの後ろに num を追加
        val node = ListNode(num)
        // キューが空なら、先頭・末尾ノードをともにそのノードに設定
        if (front == null) {
            front = node
            rear = node
            // キューが空でなければ、そのノードを末尾ノードの後ろに追加
        } else {
            rear?.next = node
            rear = node
        }
        queSize++
    }

    /* デキュー */
    fun pop(): Int {
        val num = peek()
        // 先頭ノードを削除
        front = front?.next
        queSize--
        return num
    }

    /* キュー先頭の要素にアクセス */
    fun peek(): Int {
        if (isEmpty()) throw IndexOutOfBoundsException()
        return front!!._val
    }

    /* 連結リストを Array に変換して返す */
    fun toArray(): IntArray {
        var node = front
        val res = IntArray(size())
        for (i in res.indices) {
            res[i] = node!!._val
            node = node.next
        }
        return res
    }
}
linkedlist_queue.rb
### 連結リストで実装したキュー ###
class LinkedListQueue
  ### キューの長さを取得 ###
  attr_reader :size

  ### コンストラクタ ###
  def initialize
    @front = nil  # 先頭ノード front
    @rear = nil   # 末尾ノード rear
    @size = 0
  end

  ### キューが空か判定 ###
  def is_empty?
    @front.nil?
  end

  ### エンキュー ###
  def push(num)
    # 末尾ノードの後ろに num を追加
    node = ListNode.new(num)

    # キューが空なら、先頭ノードと末尾ノードの両方をそのノードに向ける
    if @front.nil?
      @front = node
      @rear = node
    # キューが空でなければ、そのノードを末尾ノードの後ろに追加する
    else
      @rear.next = node
      @rear = node
    end

    @size += 1
  end

  ### デキュー ###
  def pop
    num = peek
    # 先頭ノードを削除
    @front = @front.next
    @size -= 1
    num
  end

  ### 先頭要素にアクセス ###
  def peek
    raise IndexError, 'キューは空です' if is_empty?

    @front.val
  end

  ### 連結リストを Array に変換して返す ###
  def to_array
    queue = []
    temp = @front
    while temp
      queue << temp.val
      temp = temp.next
    end
    queue
  end
end
コードの可視化

2.   配列に基づく実装

配列で先頭要素を削除する時間計算量は \(O(n)\) であり、そのままではデキュー操作の効率が低くなります。しかし、次の巧妙な方法によってこの問題を回避できます。

変数 front を用いてキュー先頭要素のインデックスを指し、さらに変数 size でキューの長さを記録できます。rear = front + size と定義すると、この式で得られる rear はキュー末尾要素の次の位置を指します。

この設計に基づくと、配列内で要素を含む有効区間は [front, rear - 1] となります。各種操作の実装方法を下図に示します。

  • エンキュー操作:入力要素を rear の位置に代入し、size を 1 増やします。
  • デキュー操作:front を 1 増やし、size を 1 減らすだけです。

このように、エンキューとデキューはいずれも 1 回の操作だけで済み、時間計算量はともに \(O(1)\) です。

配列でキューを実装したエンキューとデキュー操作

array_queue_push

array_queue_pop

図 5-6   配列でキューを実装したエンキューとデキュー操作

ここで 1 つ問題があります。エンキューとデキューを繰り返すと、frontrear はどちらも右へ移動し続け、配列の末尾に達するとそれ以上進めなくなります。この問題を解決するために、配列を先頭と末尾がつながった「環状配列」とみなします。

環状配列では、front または rear が配列末尾を越えたときに、直ちに配列先頭へ戻って走査を続けられるようにする必要があります。この周期的な規則は「剰余演算」によって実現できます。コードは次のとおりです:

array_queue.py
class ArrayQueue:
    """循環配列ベースのキュー"""

    def __init__(self, size: int):
        """コンストラクタ"""
        self._nums: list[int] = [0] * size  # キュー要素を格納する配列
        self._front: int = 0  # 先頭ポインタ。先頭要素を指す
        self._size: int = 0  # キューの長さ

    def capacity(self) -> int:
        """キューの容量を取得"""
        return len(self._nums)

    def size(self) -> int:
        """キューの長さを取得"""
        return self._size

    def is_empty(self) -> bool:
        """キューが空かどうかを判定"""
        return self._size == 0

    def push(self, num: int):
        """エンキュー"""
        if self._size == self.capacity():
            raise IndexError("キューがいっぱいです")
        # 末尾ポインタを計算し、末尾インデックス + 1 を指す
        # 剰余演算により、rear が配列末尾を越えた後に先頭へ戻るようにする
        rear: int = (self._front + self._size) % self.capacity()
        # num をキュー末尾に追加
        self._nums[rear] = num
        self._size += 1

    def pop(self) -> int:
        """デキュー"""
        num: int = self.peek()
        # 先頭ポインタを1つ後ろへ進め、末尾を越えたら配列先頭に戻す
        self._front = (self._front + 1) % self.capacity()
        self._size -= 1
        return num

    def peek(self) -> int:
        """キュー先頭の要素にアクセス"""
        if self.is_empty():
            raise IndexError("キューが空です")
        return self._nums[self._front]

    def to_list(self) -> list[int]:
        """表示用のリストを返す"""
        res = [0] * self.size()
        j: int = self._front
        for i in range(self.size()):
            res[i] = self._nums[(j % self.capacity())]
            j += 1
        return res
array_queue.cpp
/* 循環配列ベースのキュー */
class ArrayQueue {
  private:
    int *nums;       // キュー要素を格納する配列
    int front;       // 先頭ポインタ。先頭要素を指す
    int queSize;     // キューの長さ
    int queCapacity; // キューの容量

  public:
    ArrayQueue(int capacity) {
        // 配列を初期化
        nums = new int[capacity];
        queCapacity = capacity;
        front = queSize = 0;
    }

    ~ArrayQueue() {
        delete[] nums;
    }

    /* キューの容量を取得 */
    int capacity() {
        return queCapacity;
    }

    /* キューの長さを取得 */
    int size() {
        return queSize;
    }

    /* キューが空かどうかを判定 */
    bool isEmpty() {
        return size() == 0;
    }

    /* エンキュー */
    void push(int num) {
        if (queSize == queCapacity) {
            cout << "キューがいっぱいです" << endl;
            return;
        }
        // 末尾ポインタを計算し、末尾インデックス + 1 を指す
        // 剰余演算により、rear が配列末尾を越えた後に先頭へ戻るようにする
        int rear = (front + queSize) % queCapacity;
        // num をキュー末尾に追加
        nums[rear] = num;
        queSize++;
    }

    /* デキュー */
    int pop() {
        int num = peek();
        // 先頭ポインタを1つ後ろへ進め、末尾を越えたら配列先頭に戻す
        front = (front + 1) % queCapacity;
        queSize--;
        return num;
    }

    /* キュー先頭の要素にアクセス */
    int peek() {
        if (isEmpty())
            throw out_of_range("キューが空です");
        return nums[front];
    }

    /* 配列を Vector に変換して返す */
    vector<int> toVector() {
        // 有効長の範囲内のリスト要素のみを変換
        vector<int> arr(queSize);
        for (int i = 0, j = front; i < queSize; i++, j++) {
            arr[i] = nums[j % queCapacity];
        }
        return arr;
    }
};
array_queue.java
/* 循環配列ベースのキュー */
class ArrayQueue {
    private int[] nums; // キュー要素を格納する配列
    private int front; // 先頭ポインタ。先頭要素を指す
    private int queSize; // キューの長さ

    public ArrayQueue(int capacity) {
        nums = new int[capacity];
        front = queSize = 0;
    }

    /* キューの容量を取得 */
    public int capacity() {
        return nums.length;
    }

    /* キューの長さを取得 */
    public int size() {
        return queSize;
    }

    /* キューが空かどうかを判定 */
    public boolean isEmpty() {
        return queSize == 0;
    }

    /* エンキュー */
    public void push(int num) {
        if (queSize == capacity()) {
            System.out.println("キューは満杯です");
            return;
        }
        // 末尾ポインタを計算し、末尾インデックス + 1 を指す
        // 剰余演算により、rear が配列末尾を越えた後に先頭へ戻るようにする
        int rear = (front + queSize) % capacity();
        // num をキュー末尾に追加
        nums[rear] = num;
        queSize++;
    }

    /* デキュー */
    public int pop() {
        int num = peek();
        // 先頭ポインタを1つ後ろへ進め、末尾を越えたら配列先頭に戻す
        front = (front + 1) % capacity();
        queSize--;
        return num;
    }

    /* キュー先頭の要素にアクセス */
    public int peek() {
        if (isEmpty())
            throw new IndexOutOfBoundsException();
        return nums[front];
    }

    /* 配列を返す */
    public int[] toArray() {
        // 有効長の範囲内のリスト要素のみを変換
        int[] res = new int[queSize];
        for (int i = 0, j = front; i < queSize; i++, j++) {
            res[i] = nums[j % capacity()];
        }
        return res;
    }
}
array_queue.cs
/* 循環配列ベースのキュー */
class ArrayQueue {
    int[] nums;  // キュー要素を格納する配列
    int front;   // 先頭ポインタ。先頭要素を指す
    int queSize; // キューの長さ

    public ArrayQueue(int capacity) {
        nums = new int[capacity];
        front = queSize = 0;
    }

    /* キューの容量を取得 */
    int Capacity() {
        return nums.Length;
    }

    /* キューの長さを取得 */
    public int Size() {
        return queSize;
    }

    /* キューが空かどうかを判定 */
    public bool IsEmpty() {
        return queSize == 0;
    }

    /* エンキュー */
    public void Push(int num) {
        if (queSize == Capacity()) {
            Console.WriteLine("キューは満杯です");
            return;
        }
        // 末尾ポインタを計算し、末尾インデックス + 1 を指す
        // 剰余演算により、rear が配列末尾を越えた後に先頭へ戻るようにする
        int rear = (front + queSize) % Capacity();
        // num をキュー末尾に追加
        nums[rear] = num;
        queSize++;
    }

    /* デキュー */
    public int Pop() {
        int num = Peek();
        // 先頭ポインタを1つ後ろへ進め、末尾を越えたら配列先頭に戻す
        front = (front + 1) % Capacity();
        queSize--;
        return num;
    }

    /* キュー先頭の要素にアクセス */
    public int Peek() {
        if (IsEmpty())
            throw new Exception();
        return nums[front];
    }

    /* 配列を返す */
    public int[] ToArray() {
        // 有効長の範囲内のリスト要素のみを変換
        int[] res = new int[queSize];
        for (int i = 0, j = front; i < queSize; i++, j++) {
            res[i] = nums[j % this.Capacity()];
        }
        return res;
    }
}
array_queue.go
/* 循環配列ベースのキュー */
type arrayQueue struct {
    nums        []int // キュー要素を格納する配列
    front       int   // 先頭ポインタ。先頭要素を指す
    queSize     int   // キューの長さ
    queCapacity int   // キュー容量(格納できる要素数の上限)
}

/* キューを初期化 */
func newArrayQueue(queCapacity int) *arrayQueue {
    return &arrayQueue{
        nums:        make([]int, queCapacity),
        queCapacity: queCapacity,
        front:       0,
        queSize:     0,
    }
}

/* キューの長さを取得 */
func (q *arrayQueue) size() int {
    return q.queSize
}

/* キューが空かどうかを判定 */
func (q *arrayQueue) isEmpty() bool {
    return q.queSize == 0
}

/* エンキュー */
func (q *arrayQueue) push(num int) {
    // rear == queCapacity のときキューは満杯
    if q.queSize == q.queCapacity {
        return
    }
    // 末尾ポインタを計算し、末尾インデックス + 1 を指す
    // 剰余演算により、rear が配列末尾を越えた後に先頭へ戻るようにする
    rear := (q.front + q.queSize) % q.queCapacity
    // num をキュー末尾に追加
    q.nums[rear] = num
    q.queSize++
}

/* デキュー */
func (q *arrayQueue) pop() any {
    num := q.peek()
    if num == nil {
        return nil
    }

    // 先頭ポインタを1つ後ろへ進め、末尾を越えたら配列先頭に戻す
    q.front = (q.front + 1) % q.queCapacity
    q.queSize--
    return num
}

/* キュー先頭の要素にアクセス */
func (q *arrayQueue) peek() any {
    if q.isEmpty() {
        return nil
    }
    return q.nums[q.front]
}

/* 表示用に Slice を取得 */
func (q *arrayQueue) toSlice() []int {
    rear := (q.front + q.queSize)
    if rear >= q.queCapacity {
        rear %= q.queCapacity
        return append(q.nums[q.front:], q.nums[:rear]...)
    }
    return q.nums[q.front:rear]
}
array_queue.swift
/* 循環配列ベースのキュー */
class ArrayQueue {
    private var nums: [Int] // キュー要素を格納する配列
    private var front: Int // 先頭ポインタ。先頭要素を指す
    private var _size: Int // キューの長さ

    init(capacity: Int) {
        // 配列を初期化
        nums = Array(repeating: 0, count: capacity)
        front = 0
        _size = 0
    }

    /* キューの容量を取得 */
    func capacity() -> Int {
        nums.count
    }

    /* キューの長さを取得 */
    func size() -> Int {
        _size
    }

    /* キューが空かどうかを判定 */
    func isEmpty() -> Bool {
        size() == 0
    }

    /* エンキュー */
    func push(num: Int) {
        if size() == capacity() {
            print("キューがいっぱいです")
            return
        }
        // 末尾ポインタを計算し、末尾インデックス + 1 を指す
        // 剰余演算により、rear が配列末尾を越えた後に先頭へ戻るようにする
        let rear = (front + size()) % capacity()
        // num をキュー末尾に追加
        nums[rear] = num
        _size += 1
    }

    /* デキュー */
    @discardableResult
    func pop() -> Int {
        let num = peek()
        // 先頭ポインタを1つ後ろへ進め、末尾を越えたら配列先頭に戻す
        front = (front + 1) % capacity()
        _size -= 1
        return num
    }

    /* キュー先頭の要素にアクセス */
    func peek() -> Int {
        if isEmpty() {
            fatalError("キューが空です")
        }
        return nums[front]
    }

    /* 配列を返す */
    func toArray() -> [Int] {
        // 有効長の範囲内のリスト要素のみを変換
        (front ..< front + size()).map { nums[$0 % capacity()] }
    }
}
array_queue.js
/* 循環配列ベースのキュー */
class ArrayQueue {
    #nums; // キュー要素を格納する配列
    #front = 0; // 先頭ポインタ。先頭要素を指す
    #queSize = 0; // キューの長さ

    constructor(capacity) {
        this.#nums = new Array(capacity);
    }

    /* キューの容量を取得 */
    get capacity() {
        return this.#nums.length;
    }

    /* キューの長さを取得 */
    get size() {
        return this.#queSize;
    }

    /* キューが空かどうかを判定 */
    isEmpty() {
        return this.#queSize === 0;
    }

    /* エンキュー */
    push(num) {
        if (this.size === this.capacity) {
            console.log('キューがいっぱいです');
            return;
        }
        // 末尾ポインタを計算し、末尾インデックス + 1 を指す
        // 剰余演算により、rear が配列末尾を越えた後に先頭へ戻るようにする
        const rear = (this.#front + this.size) % this.capacity;
        // num をキュー末尾に追加
        this.#nums[rear] = num;
        this.#queSize++;
    }

    /* デキュー */
    pop() {
        const num = this.peek();
        // 先頭ポインタを1つ後ろへ進め、末尾を越えたら配列先頭に戻す
        this.#front = (this.#front + 1) % this.capacity;
        this.#queSize--;
        return num;
    }

    /* キュー先頭の要素にアクセス */
    peek() {
        if (this.isEmpty()) throw new Error('キューが空です');
        return this.#nums[this.#front];
    }

    /* Array を返す */
    toArray() {
        // 有効長の範囲内のリスト要素のみを変換
        const arr = new Array(this.size);
        for (let i = 0, j = this.#front; i < this.size; i++, j++) {
            arr[i] = this.#nums[j % this.capacity];
        }
        return arr;
    }
}
array_queue.ts
/* 循環配列ベースのキュー */
class ArrayQueue {
    private nums: number[]; // キュー要素を格納する配列
    private front: number; // 先頭ポインタ。先頭要素を指す
    private queSize: number; // キューの長さ

    constructor(capacity: number) {
        this.nums = new Array(capacity);
        this.front = this.queSize = 0;
    }

    /* キューの容量を取得 */
    get capacity(): number {
        return this.nums.length;
    }

    /* キューの長さを取得 */
    get size(): number {
        return this.queSize;
    }

    /* キューが空かどうかを判定 */
    isEmpty(): boolean {
        return this.queSize === 0;
    }

    /* エンキュー */
    push(num: number): void {
        if (this.size === this.capacity) {
            console.log('キューは満杯です');
            return;
        }
        // 末尾ポインタを計算し、末尾インデックス + 1 を指す
        // 剰余演算により、rear が配列末尾を越えた後に先頭へ戻るようにする
        const rear = (this.front + this.queSize) % this.capacity;
        // num をキュー末尾に追加
        this.nums[rear] = num;
        this.queSize++;
    }

    /* デキュー */
    pop(): number {
        const num = this.peek();
        // 先頭ポインタを1つ後ろへ進め、末尾を越えたら配列先頭に戻す
        this.front = (this.front + 1) % this.capacity;
        this.queSize--;
        return num;
    }

    /* キュー先頭の要素にアクセス */
    peek(): number {
        if (this.isEmpty()) throw new Error('キューが空です');
        return this.nums[this.front];
    }

    /* Array を返す */
    toArray(): number[] {
        // 有効長の範囲内のリスト要素のみを変換
        const arr = new Array(this.size);
        for (let i = 0, j = this.front; i < this.size; i++, j++) {
            arr[i] = this.nums[j % this.capacity];
        }
        return arr;
    }
}
array_queue.dart
/* 循環配列ベースのキュー */
class ArrayQueue {
  late List<int> _nums; // キュー要素を格納する配列
  late int _front; // 先頭ポインタ。先頭要素を指す
  late int _queSize; // キューの長さ

  ArrayQueue(int capacity) {
    _nums = List.filled(capacity, 0);
    _front = _queSize = 0;
  }

  /* キューの容量を取得 */
  int capaCity() {
    return _nums.length;
  }

  /* キューの長さを取得 */
  int size() {
    return _queSize;
  }

  /* キューが空かどうかを判定 */
  bool isEmpty() {
    return _queSize == 0;
  }

  /* エンキュー */
  void push(int _num) {
    if (_queSize == capaCity()) {
      throw Exception("キューは満杯です");
    }
    // 末尾ポインタを計算し、末尾インデックス + 1 を指す
    // 剰余演算により、rear が配列末尾を越えた後に先頭へ戻るようにする
    int rear = (_front + _queSize) % capaCity();
    // _num をキュー末尾に追加
    _nums[rear] = _num;
    _queSize++;
  }

  /* デキュー */
  int pop() {
    int _num = peek();
    // 先頭ポインタを1つ後ろへ進め、末尾を越えたら配列先頭に戻す
    _front = (_front + 1) % capaCity();
    _queSize--;
    return _num;
  }

  /* キュー先頭の要素にアクセス */
  int peek() {
    if (isEmpty()) {
      throw Exception("キューが空です");
    }
    return _nums[_front];
  }

  /* Array を返す */
  List<int> toArray() {
    // 有効長の範囲内のリスト要素のみを変換
    final List<int> res = List.filled(_queSize, 0);
    for (int i = 0, j = _front; i < _queSize; i++, j++) {
      res[i] = _nums[j % capaCity()];
    }
    return res;
  }
}
array_queue.rs
/* 循環配列ベースのキュー */
struct ArrayQueue<T> {
    nums: Vec<T>,      // キュー要素を格納する配列
    front: i32,        // 先頭ポインタ。先頭要素を指す
    que_size: i32,     // キューの長さ
    que_capacity: i32, // キューの容量
}

impl<T: Copy + Default> ArrayQueue<T> {
    /* コンストラクタ */
    fn new(capacity: i32) -> ArrayQueue<T> {
        ArrayQueue {
            nums: vec![T::default(); capacity as usize],
            front: 0,
            que_size: 0,
            que_capacity: capacity,
        }
    }

    /* キューの容量を取得 */
    fn capacity(&self) -> i32 {
        self.que_capacity
    }

    /* キューの長さを取得 */
    fn size(&self) -> i32 {
        self.que_size
    }

    /* キューが空かどうかを判定 */
    fn is_empty(&self) -> bool {
        self.que_size == 0
    }

    /* エンキュー */
    fn push(&mut self, num: T) {
        if self.que_size == self.capacity() {
            println!("キューがいっぱいです");
            return;
        }
        // 末尾ポインタを計算し、末尾インデックス + 1 を指す
        // 剰余演算により、rear が配列末尾を越えた後に先頭へ戻るようにする
        let rear = (self.front + self.que_size) % self.que_capacity;
        // num をキュー末尾に追加
        self.nums[rear as usize] = num;
        self.que_size += 1;
    }

    /* デキュー */
    fn pop(&mut self) -> T {
        let num = self.peek();
        // 先頭ポインタを1つ後ろへ進め、末尾を越えたら配列先頭に戻す
        self.front = (self.front + 1) % self.que_capacity;
        self.que_size -= 1;
        num
    }

    /* キュー先頭の要素にアクセス */
    fn peek(&self) -> T {
        if self.is_empty() {
            panic!("index out of bounds");
        }
        self.nums[self.front as usize]
    }

    /* 配列を返す */
    fn to_vector(&self) -> Vec<T> {
        let cap = self.que_capacity;
        let mut j = self.front;
        let mut arr = vec![T::default(); cap as usize];
        for i in 0..self.que_size {
            arr[i as usize] = self.nums[(j % cap) as usize];
            j += 1;
        }
        arr
    }
}
array_queue.c
/* 循環配列ベースのキュー */
typedef struct {
    int *nums;       // キュー要素を格納する配列
    int front;       // 先頭ポインタ。先頭要素を指す
    int queSize;     // 現在のキュー内の要素数
    int queCapacity; // キューの容量
} ArrayQueue;

/* コンストラクタ */
ArrayQueue *newArrayQueue(int capacity) {
    ArrayQueue *queue = (ArrayQueue *)malloc(sizeof(ArrayQueue));
    // 配列を初期化
    queue->queCapacity = capacity;
    queue->nums = (int *)malloc(sizeof(int) * queue->queCapacity);
    queue->front = queue->queSize = 0;
    return queue;
}

/* デストラクタ */
void delArrayQueue(ArrayQueue *queue) {
    free(queue->nums);
    free(queue);
}

/* キューの容量を取得 */
int capacity(ArrayQueue *queue) {
    return queue->queCapacity;
}

/* キューの長さを取得 */
int size(ArrayQueue *queue) {
    return queue->queSize;
}

/* キューが空かどうかを判定 */
bool empty(ArrayQueue *queue) {
    return queue->queSize == 0;
}

/* キュー先頭の要素にアクセス */
int peek(ArrayQueue *queue) {
    assert(size(queue) != 0);
    return queue->nums[queue->front];
}

/* エンキュー */
void push(ArrayQueue *queue, int num) {
    if (size(queue) == capacity(queue)) {
        printf("キューは満杯です\r\n");
        return;
    }
    // 末尾ポインタを計算し、末尾インデックス + 1 を指す
    // 剰余演算により、rear が配列末尾を越えた後に先頭へ戻るようにする
    int rear = (queue->front + queue->queSize) % queue->queCapacity;
    // num をキュー末尾に追加
    queue->nums[rear] = num;
    queue->queSize++;
}

/* デキュー */
int pop(ArrayQueue *queue) {
    int num = peek(queue);
    // 先頭ポインタを1つ後ろへ進め、末尾を越えたら配列先頭に戻す
    queue->front = (queue->front + 1) % queue->queCapacity;
    queue->queSize--;
    return num;
}

/* 出力用の配列を返す */
int *toArray(ArrayQueue *queue, int *queSize) {
    *queSize = queue->queSize;
    int *res = (int *)calloc(queue->queSize, sizeof(int));
    int j = queue->front;
    for (int i = 0; i < queue->queSize; i++) {
        res[i] = queue->nums[j % queue->queCapacity];
        j++;
    }
    return res;
}
array_queue.kt
/* 循環配列ベースのキュー */
class ArrayQueue(capacity: Int) {
    private val nums: IntArray = IntArray(capacity) // キュー要素を格納する配列
    private var front: Int = 0 // 先頭ポインタ。先頭要素を指す
    private var queSize: Int = 0 // キューの長さ

    /* キューの容量を取得 */
    fun capacity(): Int {
        return nums.size
    }

    /* キューの長さを取得 */
    fun size(): Int {
        return queSize
    }

    /* キューが空かどうかを判定 */
    fun isEmpty(): Boolean {
        return queSize == 0
    }

    /* エンキュー */
    fun push(num: Int) {
        if (queSize == capacity()) {
            println("キューは満杯です")
            return
        }
        // 末尾ポインタを計算し、末尾インデックス + 1 を指す
        // 剰余演算により、rear が配列末尾を越えた後に先頭へ戻るようにする
        val rear = (front + queSize) % capacity()
        // num をキュー末尾に追加
        nums[rear] = num
        queSize++
    }

    /* デキュー */
    fun pop(): Int {
        val num = peek()
        // 先頭ポインタを1つ後ろへ進め、末尾を越えたら配列先頭に戻す
        front = (front + 1) % capacity()
        queSize--
        return num
    }

    /* キュー先頭の要素にアクセス */
    fun peek(): Int {
        if (isEmpty()) throw IndexOutOfBoundsException()
        return nums[front]
    }

    /* 配列を返す */
    fun toArray(): IntArray {
        // 有効長の範囲内のリスト要素のみを変換
        val res = IntArray(queSize)
        var i = 0
        var j = front
        while (i < queSize) {
            res[i] = nums[j % capacity()]
            i++
            j++
        }
        return res
    }
}
array_queue.rb
### 循環配列で実装したキュー ###
class ArrayQueue
  ### キューの長さを取得 ###
  attr_reader :size

  ### コンストラクタ ###
  def initialize(size)
    @nums = Array.new(size, 0) # キュー要素を格納する配列
    @front = 0 # 先頭ポインタ。先頭要素を指す
    @size = 0 # キューの長さ
  end

  ### キューの容量を取得 ###
  def capacity
    @nums.length
  end

  ### キューが空か判定 ###
  def is_empty?
    size.zero?
  end

  ### エンキュー ###
  def push(num)
    raise IndexError, 'キューがいっぱいです' if size == capacity

    # 末尾ポインタを計算し、末尾インデックス + 1 を指す
    # 剰余演算により、rear が配列末尾を越えた後に先頭へ戻るようにする
    rear = (@front + size) % capacity
    # num をキュー末尾に追加
    @nums[rear] = num
    @size += 1
  end

  ### デキュー ###
  def pop
    num = peek
    # 先頭ポインタを1つ後ろへ進め、末尾を越えたら配列先頭に戻す
    @front = (@front + 1) % capacity
    @size -= 1
    num
  end

  ### 先頭要素にアクセス ###
  def peek
    raise IndexError, 'キューは空です' if is_empty?

    @nums[@front]
  end

  ### 表示用のリストを返す ###
  def to_array
    res = Array.new(size, 0)
    j = @front

    for i in 0...size
      res[i] = @nums[j % capacity]
      j += 1
    end

    res
  end
end
コードの可視化

上記の実装によるキューにも制約があり、長さを可変にできません。しかし、この問題の解決は難しくなく、配列を動的配列に置き換えれば容量拡張の仕組みを導入できます。興味があれば自分で実装してみてください。

2 つの実装の比較に関する結論はスタックの場合と同じなので、ここでは繰り返しません。

5.2.3   キューの典型的な応用

  • 淘宝の注文。購入者が注文すると、その注文はキューに追加され、システムは順番に従って注文を処理します。ダブルイレブンの期間には短時間で膨大な注文が発生するため、高並行性がエンジニアにとって重点的に解決すべき課題になります。
  • 各種の待機事項。先着順の機能を実現する必要があるあらゆる場面、たとえばプリンターのジョブキューや飲食店の配膳キューなどでは、キューによって処理順序を効果的に維持できます。
ご意見、ご質問、ご提案があればぜひコメントしてください