Re-translate the Japanese version (#1871)

* Retranslate Japanese docs with GPT-5.4

* Retranslate Japanese code with GPT-5.4
This commit is contained in:
Yudong Jin
2026-03-30 07:30:15 +08:00
committed by GitHub
parent fe6443235b
commit d7b2277d2b
1444 changed files with 83312 additions and 8363 deletions

View File

@@ -1,25 +1,25 @@
# 両端キュー
キューでは、先頭からの要素削除や末尾への要素追加のみが可能です。下図に示すように、<u>両端キューdeque</u>はより柔軟性を提供し、先頭と末尾の両方で要素の追加や削除を可能にします。
キューでは、先頭要素削除するか末尾に要素追加することしかできません。次の図に示すように、<u>両端キューdouble-ended queue</u>はより高い柔軟性を備えており、先頭と末尾の両方で要素の追加や削除を行えます。
![両端キューの操作](deque.assets/deque_operations.png)
## 両端キューの一般的な操作
## 両端キューの基本操作
両端キューの一般的な操作は以下の通りです。具体的なメソッド名は使用するプログラミング言語によって異なります。
両端キューの基本操作を次の表に示します。具体的なメソッド名は使用するプログラミング言語によって異なります。
<p align="center"> 表 <id> &nbsp; 両端キューの操作効率 </p>
| メソッド名 | 説明 | 時間計算量 |
| ------------- | ------------------ | ------------- |
| `pushFirst()` | 先頭に要素を追加 | $O(1)$ |
| `pushLast()` | 末尾に要素を追加 | $O(1)$ |
| `popFirst()` | 先頭要素を削除 | $O(1)$ |
| `popLast()` | 末尾要素を削除 | $O(1)$ |
| `peekFirst()` | 先頭要素にアクセス | $O(1)$ |
| `peekLast()` | 末尾要素にアクセス | $O(1)$ |
| メソッド名 | 説明 | 時間計算量 |
| -------------- | ---------------- | ---------- |
| `push_first()` | 先頭に要素を追加 | $O(1)$ |
| `push_last()` | 末尾に要素を追加 | $O(1)$ |
| `pop_first()` | 先頭要素を削除 | $O(1)$ |
| `pop_last()` | 末尾要素を削除 | $O(1)$ |
| `peek_first()` | 先頭要素にアクセス | $O(1)$ |
| `peek_last()` | 末尾要素にアクセス | $O(1)$ |
同様に、プログラミング言語実装され両端キュークラスを直接使用することできます:
同様に、プログラミング言語に組み込み実装されている両端キュークラスを直接使ことできます:
=== "Python"
@@ -47,7 +47,7 @@
# 両端キューの長さを取得
size: int = len(deq)
# 両端キューが空かどうかを確認
# 両端キューが空かどうかを判定
is_empty: bool = len(deq) == 0
```
@@ -75,7 +75,7 @@
/* 両端キューの長さを取得 */
int size = deque.size();
/* 両端キューが空かどうかを確認 */
/* 両端キューが空かどうかを判定 */
bool empty = deque.empty();
```
@@ -103,7 +103,7 @@
/* 両端キューの長さを取得 */
int size = deque.size();
/* 両端キューが空かどうかを確認 */
/* 両端キューが空かどうかを判定 */
boolean isEmpty = deque.isEmpty();
```
@@ -111,7 +111,7 @@
```csharp title="deque.cs"
/* 両端キューを初期化 */
// C#では、LinkedListを両端キューとして使用
// C# では、連結リスト LinkedList を両端キューとして使用する
LinkedList<int> deque = new();
/* 要素をエンキュー */
@@ -132,7 +132,7 @@
/* 両端キューの長さを取得 */
int size = deque.Count;
/* 両端キューが空かどうかを確認 */
/* 両端キューが空かどうかを判定 */
bool isEmpty = deque.Count == 0;
```
@@ -140,7 +140,7 @@
```go title="deque_test.go"
/* 両端キューを初期化 */
// Goでは、listを両端キューとして使用
// Go では、list を両端キューとして使用する
deque := list.New()
/* 要素をエンキュー */
@@ -161,7 +161,7 @@
/* 両端キューの長さを取得 */
size := deque.Len()
/* 両端キューが空かどうかを確認 */
/* 両端キューが空かどうかを判定 */
isEmpty := deque.Len() == 0
```
@@ -169,7 +169,7 @@
```swift title="deque.swift"
/* 両端キューを初期化 */
// Swiftには組み込みの両端キュークラスがないため、Arrayを両端キューとして使用
// Swift には組み込みの両端キュークラスがないため、Array を両端キューとして使用する
var deque: [Int] = []
/* 要素をエンキュー */
@@ -181,17 +181,17 @@
/* 要素にアクセス */
let peekFirst = deque.first! // 先頭要素
let peekLast = deque.last! // 末尾要素
let peekLast = deque.last! // 末尾要素
/* 要素をデキュー */
// Arrayを使用する場合、popFirstの計算量はO(n)
// Array で模擬する場合、popFirst の計算量は O(n)
let popFirst = deque.removeFirst() // 先頭要素をデキュー
let popLast = deque.removeLast() // 末尾要素をデキュー
let popLast = deque.removeLast() // 末尾要素をデキュー
/* 両端キューの長さを取得 */
let size = deque.count
/* 両端キューが空かどうかを確認 */
/* 両端キューが空かどうかを判定 */
let isEmpty = deque.isEmpty
```
@@ -199,30 +199,30 @@
```javascript title="deque.js"
/* 両端キューを初期化 */
// JavaScriptには組み込みの両端キューがないため、Arrayを両端キューとして使用
// JavaScript には組み込みの両端キューがないため、Array を両端キューとして使用するしかない
const deque = [];
/* 要素をエンキュー */
deque.push(2);
deque.push(5);
deque.push(4);
// 注意:unshift()は配列のため時間計算量O(n)
// 配列であるため、unshift() メソッドの時間計算量O(n) です
deque.unshift(3);
deque.unshift(1);
/* 要素にアクセス */
const peekFirst = deque[0]; // 先頭要素
const peekLast = deque[deque.length - 1]; // 末尾要素
const peekFirst = deque[0];
const peekLast = deque[deque.length - 1];
/* 要素をデキュー */
// 注意:shift()は配列のため時間計算量O(n)
const popFront = deque.shift(); // 先頭要素をデキュー
const popBack = deque.pop(); // 末尾要素をデキュー
// 配列であるため、shift() メソッドの時間計算量O(n) です
const popFront = deque.shift();
const popBack = deque.pop();
/* 両端キューの長さを取得 */
const size = deque.length;
/* 両端キューが空かどうかを確認 */
/* 両端キューが空かどうかを判定 */
const isEmpty = size === 0;
```
@@ -230,30 +230,30 @@
```typescript title="deque.ts"
/* 両端キューを初期化 */
// TypeScriptには組み込みの両端キューがないため、Arrayを両端キューとして使用
// TypeScript には組み込みの両端キューがないため、Array を両端キューとして使用するしかない
const deque: number[] = [];
/* 要素をエンキュー */
deque.push(2);
deque.push(5);
deque.push(4);
// 注意:unshift()は配列のため時間計算量O(n)
// 配列であるため、unshift() メソッドの時間計算量O(n) です
deque.unshift(3);
deque.unshift(1);
/* 要素にアクセス */
const peekFirst: number = deque[0]; // 先頭要素
const peekLast: number = deque[deque.length - 1]; // 末尾要素
const peekFirst: number = deque[0];
const peekLast: number = deque[deque.length - 1];
/* 要素をデキュー */
// 注意:shift()は配列のため時間計算量O(n)
const popFront: number = deque.shift() as number; // 先頭要素をデキュー
const popBack: number = deque.pop() as number; // 末尾要素をデキュー
// 配列であるため、shift() メソッドの時間計算量O(n) です
const popFront: number = deque.shift() as number;
const popBack: number = deque.pop() as number;
/* 両端キューの長さを取得 */
const size: number = deque.length;
/* 両端キューが空かどうかを確認 */
/* 両端キューが空かどうかを判定 */
const isEmpty: boolean = size === 0;
```
@@ -261,7 +261,7 @@
```dart title="deque.dart"
/* 両端キューを初期化 */
// Dartでは、Queue両端キューとして定義され
// Dart では、Queue両端キューとして定義されています
Queue<int> deque = Queue<int>();
/* 要素をエンキュー */
@@ -282,7 +282,7 @@
/* 両端キューの長さを取得 */
int size = deque.length;
/* 両端キューが空かどうかを確認 */
/* 両端キューが空かどうかを判定 */
bool isEmpty = deque.isEmpty;
```
@@ -314,50 +314,107 @@
/* 両端キューの長さを取得 */
let size = deque.len();
/* 両端キューが空かどうかを確認 */
/* 両端キューが空かどうかを判定 */
let is_empty = deque.is_empty();
```
=== "C"
```c title="deque.c"
// Cには組み込みの両端キューが提供されていません
// C には組み込みの両端キューがありません
```
=== "Kotlin"
```kotlin title="deque.kt"
/* 両端キューを初期化 */
val deque = LinkedList<Int>()
/* 要素をエンキュー */
deque.offerLast(2) // 末尾に追加
deque.offerLast(5)
deque.offerLast(4)
deque.offerFirst(3) // 先頭に追加
deque.offerFirst(1)
/* 要素にアクセス */
val peekFirst = deque.peekFirst() // 先頭要素
val peekLast = deque.peekLast() // 末尾要素
/* 要素をデキュー */
val popFirst = deque.pollFirst() // 先頭要素をデキュー
val popLast = deque.pollLast() // 末尾要素をデキュー
/* 両端キューの長さを取得 */
val size = deque.size
/* 両端キューが空かどうかを判定 */
val isEmpty = deque.isEmpty()
```
=== "Ruby"
```ruby title="deque.rb"
# 両端キューを初期化
# Ruby には組み込みの両端キューがないため、Array を両端キューとして使用するしかありません
deque = []
# 要素をエンキュー
deque << 2
deque << 5
deque << 4
# 配列であるため、Array#unshift メソッドの時間計算量は O(n) です
deque.unshift(3)
deque.unshift(1)
# 要素にアクセス
peek_first = deque.first
peek_last = deque.last
# 要素をデキュー
# 配列であるため、 Array#shift メソッドの時間計算量は O(n) です
pop_front = deque.shift
pop_back = deque.pop
# 両端キューの長さを取得
size = deque.length
# 両端キューが空かどうかを判定
is_empty = size.zero?
```
??? pythontutor "実行の可視化"
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%E5%8F%8C%E5%90%91%E9%98%9F%E5%88%97%0A%20%20%20%20deq%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%20deq.append%282%29%20%20%23%20%E6%B7%BB%E5%8A%A0%E8%87%B3%E9%98%9F%E5%B0%BE%0A%20%20%20%20deq.append%285%29%0A%20%20%20%20deq.append%284%29%0A%20%20%20%20deq.appendleft%283%29%20%20%23%20%E6%B7%BB%E5%8A%A0%E8%87%B3%E9%98%9F%E9%A6%96%0A%20%20%20%20deq.appendleft%281%29%0A%20%20%20%20print%28%22%E5%8F%8C%E5%90%91%E9%98%9F%E5%88%97%20deque%20%3D%22,%20deq%29%0A%0A%20%20%20%20%23%20%E8%AE%BF%E9%97%AE%E5%85%83%E7%B4%A0%0A%20%20%20%20front%20%3D%20deq%5B0%5D%20%20%23%20%E9%98%9F%E9%A6%96%E5%85%83%E7%B4%A0%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%20%20%20%20rear%20%3D%20deq%5B-1%5D%20%20%23%20%E9%98%9F%E5%B0%BE%E5%85%83%E7%B4%A0%0A%20%20%20%20print%28%22%E9%98%9F%E5%B0%BE%E5%85%83%E7%B4%A0%20rear%20%3D%22,%20rear%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_front%20%3D%20deq.popleft%28%29%20%20%23%20%E9%98%9F%E9%A6%96%E5%85%83%E7%B4%A0%E5%87%BA%E9%98%9F%0A%20%20%20%20print%28%22%E9%98%9F%E9%A6%96%E5%87%BA%E9%98%9F%E5%85%83%E7%B4%A0%20%20pop_front%20%3D%22,%20pop_front%29%0A%20%20%20%20print%28%22%E9%98%9F%E9%A6%96%E5%87%BA%E9%98%9F%E5%90%8E%20deque%20%3D%22,%20deq%29%0A%20%20%20%20pop_rear%20%3D%20deq.pop%28%29%20%20%23%20%E9%98%9F%E5%B0%BE%E5%85%83%E7%B4%A0%E5%87%BA%E9%98%9F%0A%20%20%20%20print%28%22%E9%98%9F%E5%B0%BE%E5%87%BA%E9%98%9F%E5%85%83%E7%B4%A0%20%20pop_rear%20%3D%22,%20pop_rear%29%0A%20%20%20%20print%28%22%E9%98%9F%E5%B0%BE%E5%87%BA%E9%98%9F%E5%90%8E%20deque%20%3D%22,%20deq%29%0A%0A%20%20%20%20%23%20%E8%8E%B7%E5%8F%96%E5%8F%8C%E5%90%91%E9%98%9F%E5%88%97%E7%9A%84%E9%95%BF%E5%BA%A6%0A%20%20%20%20size%20%3D%20len%28deq%29%0A%20%20%20%20print%28%22%E5%8F%8C%E5%90%91%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%E5%8F%8C%E5%90%91%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%28deq%29%20%3D%3D%200%0A%20%20%20%20print%28%22%E5%8F%8C%E5%90%91%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
## 両端キューの実装 *
両端キューの実装は通常のキューの実装と似ており、連結リストまたは配列を基盤となるデータ構造として使用できます。
両端キューの実装はキューと似ており、連結リストまたは配列を基盤となるデータ構造として選べます。
### 双方向連結リストに基づく実装
前節、通常の単連結リストを使ってキューを実装したことを思い出してください。これは先頭からの削除(デキュー操作に対応)と末尾への新しい要素の追加(エンキュー操作に対応)を便利に行えるためでした
前節を振り返ると、通常の単方向連結リストを使ってキューを実装しました。これは先頭ノードの削除(デキューに対応)と末尾ノードの後ろへの新規ノード追加(エンキューに対応)を容易に行えるためで
両端キューでは、先頭と末尾の両方でエンキューとデキュー操作を実行できます。つまり、両端キューは逆方向の操作も実装する必要があります。のため、両端キューの基盤となるデータ構造として「双方向連結リスト」を使用します。
両端キューでは、先頭と末尾のどちらでもエンキューとデキューを行えます。言い換えると、両端キューではもう一方の対称方向の操作も実装する必要があります。のため、両端キューの基盤データ構造として「双方向連結リスト」を用します。
図に示すように、双方向連結リストの先頭ノードと末尾ノードをそれぞれ両端キューの前端と後端として扱い、両端でノード追加と削除機能を実します。
次の図に示すように、双方向連結リストの先頭ノードと末尾ノードを両端キューの先頭と末尾と見なし、両端でノード追加および削除する機能を実します。
=== "LinkedListDeque"
![双方向連結リストによる両端キューのエンキューとデキュー操作の実装](deque.assets/linkedlist_deque_step1.png)
![連結リストによる両端キューのエンキューとデキュー](deque.assets/linkedlist_deque_step1.png)
=== "pushLast()"
=== "push_last()"
![linkedlist_deque_push_last](deque.assets/linkedlist_deque_step2_push_last.png)
=== "pushFirst()"
=== "push_first()"
![linkedlist_deque_push_first](deque.assets/linkedlist_deque_step3_push_first.png)
=== "popLast()"
=== "pop_last()"
![linkedlist_deque_pop_last](deque.assets/linkedlist_deque_step4_pop_last.png)
=== "popFirst()"
=== "pop_first()"
![linkedlist_deque_pop_first](deque.assets/linkedlist_deque_step5_pop_first.png)
実装コードは以下の通りです:
実装コードは次のとおりです:
```src
[file]{linkedlist_deque}-[class]{linked_list_deque}-[func]{}
@@ -365,24 +422,24 @@
### 配列に基づく実装
図に示すように、配列キュー実装するのと同様に、循環配列を使って両端キューを実装することもできます。
次の図に示すように、配列によるキュー実装と同様に、循環配列を使って両端キューを実装することもできます。
=== "ArrayDeque"
![配列による両端キューのエンキューとデキュー操作の実装](deque.assets/array_deque_step1.png)
![配列による両端キューのエンキューとデキュー](deque.assets/array_deque_step1.png)
=== "pushLast()"
=== "push_last()"
![array_deque_push_last](deque.assets/array_deque_step2_push_last.png)
=== "pushFirst()"
=== "push_first()"
![array_deque_push_first](deque.assets/array_deque_step3_push_first.png)
=== "popLast()"
=== "pop_last()"
![array_deque_pop_last](deque.assets/array_deque_step4_pop_last.png)
=== "popFirst()"
=== "pop_first()"
![array_deque_pop_first](deque.assets/array_deque_step5_pop_first.png)
実装では「前端エンキュー」と「後端デキュー」のメソッドを追加するだけです:
キュー実装を土台として、「先頭へのエンキュー」と「末尾からのデキュー」のメソッドを追加するだけで済みます:
```src
[file]{array_deque}-[class]{array_deque}-[func]{}
@@ -390,6 +447,6 @@
## 両端キューの応用
両端キューはスタックとキューの両方のロジックを組み合わせているため、**それぞれのすべてのユースケースを実でき、より大きな柔軟性を提供します**。
両端キューはスタックとキューの両方の論理を備えているため、**これら 2 つのすべての応用場面を実でき、さらに高い自由度を提供します**。
ソフトウェアの「元に戻す」機能は通常スタックを使って実装されることを知っていますシステムは変更操作をスタックに`push`し、次に`pop`して元に戻すことを実します。しかし、システムリソースの制を考慮して、ソフトウェアは元に戻すステップの数を制限することがよくあります例えば、最後の50ステップのみを許可。スタックの長さが50を超えた場合、ソフトウェアはスタックの底部(キューの前端)で削除操作を実行する必要があります。**しかし、通常のスタックではこの機能を実できないため、両端キューが必要になります**。「元に戻す」のコアロジックは依然としてスタックの後入れ先出し原則に従いますが、両端キューはより柔軟にいくつかの追加ロジックを実装できることに注意してください
私たちが知っているように、ソフトウェアの「元に戻す」機能は通常スタックを使って実装されますシステムは変更操作を毎回スタックに `push` し、その後 `pop` によって取り消しを実します。しかし、システム資源の制を考慮すると、通常ソフトウェアは取り消し可能な手数を制限します(たとえば $50$ 手まで保存可能)。スタックの長さが $50$ を超えると、ソフトウェアはスタックの底部(先頭)で削除操作を行う必要があります。**しかしスタックではこの機能を実できないため、この場合はスタックの代わりに両端キューを使用する必要があります**。なお、「元に戻す」の中核ロジック自体は依然としてスタックの後入れ先出し原則に従っており、両端キューは追加ロジックをより柔軟に実装できるだけです