hello-algo/zh-hant/codes/python/chapter_stack_and_queue/array_deque.py
Yudong Jin 5f7385c8a3
feat: Traditional Chinese version (#1163)
* First commit

* Update mkdocs.yml

* Translate all the docs to traditional Chinese

* Translate the code files.

* Translate the docker file

* Fix mkdocs.yml

* Translate all the figures from SC to TC

* 二叉搜尋樹 -> 二元搜尋樹

* Update terminology.

* Update terminology

* 构造函数/构造方法 -> 建構子
异或 -> 互斥或

* 擴充套件 -> 擴展

* constant - 常量 - 常數

* 類	-> 類別

* AVL -> AVL 樹

* 數組 -> 陣列

* 係統 -> 系統
斐波那契數列 -> 費波那契數列
運算元量 -> 運算量
引數 -> 參數

* 聯絡 -> 關聯

* 麵試 -> 面試

* 面向物件 -> 物件導向
歸併排序 -> 合併排序
范式 -> 範式

* Fix 算法 -> 演算法

* 錶示 -> 表示
反碼 -> 一補數
補碼 -> 二補數
列列尾部 -> 佇列尾部
區域性性 -> 區域性
一摞 -> 一疊

* Synchronize with main branch

* 賬號 -> 帳號
推匯 -> 推導

* Sync with main branch

* First commit

* Update mkdocs.yml

* Translate all the docs to traditional Chinese

* Translate the code files.

* Translate the docker file

* Fix mkdocs.yml

* Translate all the figures from SC to TC

* 二叉搜尋樹 -> 二元搜尋樹

* Update terminology

* 构造函数/构造方法 -> 建構子
异或 -> 互斥或

* 擴充套件 -> 擴展

* constant - 常量 - 常數

* 類	-> 類別

* AVL -> AVL 樹

* 數組 -> 陣列

* 係統 -> 系統
斐波那契數列 -> 費波那契數列
運算元量 -> 運算量
引數 -> 參數

* 聯絡 -> 關聯

* 麵試 -> 面試

* 面向物件 -> 物件導向
歸併排序 -> 合併排序
范式 -> 範式

* Fix 算法 -> 演算法

* 錶示 -> 表示
反碼 -> 一補數
補碼 -> 二補數
列列尾部 -> 佇列尾部
區域性性 -> 區域性
一摞 -> 一疊

* Synchronize with main branch

* 賬號 -> 帳號
推匯 -> 推導

* Sync with main branch

* Update terminology.md

* 操作数量(num. of operations)-> 操作數量

* 字首和->前綴和

* Update figures

* 歸 -> 迴
記憶體洩漏 -> 記憶體流失

* Fix the bug of the file filter

* 支援 -> 支持
Add zh-Hant/README.md

* Add the zh-Hant chapter covers.
Bug fixes.

* 外掛 -> 擴充功能

* Add the landing page for zh-Hant version

* Unify the font of the chapter covers for the zh, en, and zh-Hant version

* Move zh-Hant/ to zh-hant/

* Translate terminology.md to traditional Chinese
2024-04-06 02:30:11 +08:00

129 lines
3.9 KiB
Python

"""
File: array_deque.py
Created Time: 2023-03-01
Author: krahets (krahets@163.com)
"""
class ArrayDeque:
"""基於環形陣列實現的雙向佇列"""
def __init__(self, capacity: int):
"""建構子"""
self._nums: list[int] = [0] * capacity
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 index(self, i: int) -> int:
"""計算環形陣列索引"""
# 透過取餘操作實現陣列首尾相連
# 當 i 越過陣列尾部後,回到頭部
# 當 i 越過陣列頭部後,回到尾部
return (i + self.capacity()) % self.capacity()
def push_first(self, num: int):
"""佇列首入列"""
if self._size == self.capacity():
print("雙向佇列已滿")
return
# 佇列首指標向左移動一位
# 透過取餘操作實現 front 越過陣列頭部後回到尾部
self._front = self.index(self._front - 1)
# 將 num 新增至佇列首
self._nums[self._front] = num
self._size += 1
def push_last(self, num: int):
"""佇列尾入列"""
if self._size == self.capacity():
print("雙向佇列已滿")
return
# 計算佇列尾指標,指向佇列尾索引 + 1
rear = self.index(self._front + self._size)
# 將 num 新增至佇列尾
self._nums[rear] = num
self._size += 1
def pop_first(self) -> int:
"""佇列首出列"""
num = self.peek_first()
# 佇列首指標向後移動一位
self._front = self.index(self._front + 1)
self._size -= 1
return num
def pop_last(self) -> int:
"""佇列尾出列"""
num = self.peek_last()
self._size -= 1
return num
def peek_first(self) -> int:
"""訪問佇列首元素"""
if self.is_empty():
raise IndexError("雙向佇列為空")
return self._nums[self._front]
def peek_last(self) -> int:
"""訪問佇列尾元素"""
if self.is_empty():
raise IndexError("雙向佇列為空")
# 計算尾元素索引
last = self.index(self._front + self._size - 1)
return self._nums[last]
def to_array(self) -> list[int]:
"""返回陣列用於列印"""
# 僅轉換有效長度範圍內的串列元素
res = []
for i in range(self._size):
res.append(self._nums[self.index(self._front + i)])
return res
"""Driver Code"""
if __name__ == "__main__":
# 初始化雙向佇列
deque = ArrayDeque(10)
deque.push_last(3)
deque.push_last(2)
deque.push_last(5)
print("雙向佇列 deque =", deque.to_array())
# 訪問元素
peek_first: int = deque.peek_first()
print("佇列首元素 peek_first =", peek_first)
peek_last: int = deque.peek_last()
print("佇列尾元素 peek_last =", peek_last)
# 元素入列
deque.push_last(4)
print("元素 4 佇列尾入列後 deque =", deque.to_array())
deque.push_first(1)
print("元素 1 佇列首入列後 deque =", deque.to_array())
# 元素出列
pop_last: int = deque.pop_last()
print("佇列尾出列元素 =", pop_last, ",佇列尾出列後 deque =", deque.to_array())
pop_first: int = deque.pop_first()
print("佇列首出列元素 =", pop_first, ",佇列首出列後 deque =", deque.to_array())
# 獲取雙向佇列的長度
size: int = deque.size()
print("雙向佇列長度 size =", size)
# 判斷雙向佇列是否為空
is_empty: bool = deque.is_empty()
print("雙向佇列是否為空 =", is_empty)