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
@@ -0,0 +1,145 @@
/**
* File: array_deque.kt
* Created Time: 2024-01-25
* Author: curtishd (1023632660@qq.com)
*/
package chapter_stack_and_queue
/* 循環配列ベースの両端キュー */
/* コンストラクタ */
class ArrayDeque(capacity: Int) {
private var 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
}
/* 循環配列のインデックスを計算 */
private fun index(i: Int): Int {
// 剰余演算により配列の先頭と末尾をつなげる
// i が配列の末尾を越えたら先頭に戻る
// i が配列の先頭を越えて前に出たら末尾に戻る
return (i + capacity()) % capacity()
}
/* キュー先頭にエンキュー */
fun pushFirst(num: Int) {
if (queSize == capacity()) {
println("双方向キューは満杯です")
return
}
// 先頭ポインタを左に 1 つ移動する
// 剰余演算により、front が配列先頭を越えた後に末尾へ戻るようにする
front = index(front - 1)
// num をキュー先頭に追加
nums[front] = num
queSize++
}
/* キュー末尾にエンキュー */
fun pushLast(num: Int) {
if (queSize == capacity()) {
println("双方向キューは満杯です")
return
}
// キュー末尾ポインタを計算し、末尾インデックス + 1 を指す
val rear = index(front + queSize)
// num をキュー末尾に追加
nums[rear] = num
queSize++
}
/* キュー先頭からデキュー */
fun popFirst(): Int {
val num = peekFirst()
// 先頭ポインタを 1 つ後ろへ進める
front = index(front + 1)
queSize--
return num
}
/* キュー末尾からデキュー */
fun popLast(): Int {
val num = peekLast()
queSize--
return num
}
/* キュー先頭の要素にアクセス */
fun peekFirst(): Int {
if (isEmpty()) throw IndexOutOfBoundsException()
return nums[front]
}
/* キュー末尾の要素にアクセス */
fun peekLast(): Int {
if (isEmpty()) throw IndexOutOfBoundsException()
// 末尾要素のインデックスを計算
val last = index(front + queSize - 1)
return nums[last]
}
/* 出力用の配列を返す */
fun toArray(): IntArray {
// 有効長の範囲内のリスト要素のみを変換
val res = IntArray(queSize)
var i = 0
var j = front
while (i < queSize) {
res[i] = nums[index(j)]
i++
j++
}
return res
}
}
/* Driver Code */
fun main() {
/* 両端キューを初期化 */
val deque = ArrayDeque(10)
deque.pushLast(3)
deque.pushLast(2)
deque.pushLast(5)
println("双方向キュー deque = ${deque.toArray().contentToString()}")
/* 要素にアクセス */
val peekFirst = deque.peekFirst()
println("先頭要素 peekFirst = $peekFirst")
val peekLast = deque.peekLast()
println("末尾要素 peekLast = $peekLast")
/* 要素をエンキュー */
deque.pushLast(4)
println("要素 4 を末尾に追加した後 deque = ${deque.toArray().contentToString()}")
deque.pushFirst(1)
println("要素 1 を先頭に追加した後 deque = ${deque.toArray().contentToString()}")
/* 要素をデキュー */
val popLast = deque.popLast()
println("末尾から取り出した要素 = ${popLast}、末尾から取り出した後 deque = ${deque.toArray().contentToString()}")
val popFirst = deque.popFirst()
println("先頭から取り出した要素 = ${popFirst}、先頭から取り出した後 deque = ${deque.toArray().contentToString()}")
/* 両端キューの長さを取得 */
val size = deque.size()
println("双方向キューの長さ size = $size")
/* 両端キューが空かどうかを判定 */
val isEmpty = deque.isEmpty()
println("双方向キューが空かどうか = $isEmpty")
}
@@ -0,0 +1,110 @@
/**
* File: array_queue.kt
* Created Time: 2024-01-25
* Author: curtishd (1023632660@qq.com)
*/
package chapter_stack_and_queue
/* 循環配列ベースのキュー */
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
}
}
/* Driver Code */
fun main() {
/* キューを初期化 */
val capacity = 10
val queue = ArrayQueue(capacity)
/* 要素をエンキュー */
queue.push(1)
queue.push(3)
queue.push(2)
queue.push(5)
queue.push(4)
println("キュー queue = ${queue.toArray().contentToString()}")
/* キュー先頭の要素にアクセス */
val peek = queue.peek()
println("先頭要素 peek = $peek")
/* 要素をデキュー */
val pop = queue.pop()
println("取り出した要素 pop = ${pop}、取り出した後 queue = ${queue.toArray().contentToString()}")
/* キューの長さを取得 */
val size = queue.size()
println("キューの長さ size = $size")
/* キューが空かどうかを判定 */
val isEmpty = queue.isEmpty()
println("キューが空かどうか = $isEmpty")
/* 循環配列をテストする */
for (i in 0..9) {
queue.push(i)
queue.pop()
println("$i ラウンドの追加 + 取り出し後 queue = ${queue.toArray().contentToString()}")
}
}
@@ -0,0 +1,75 @@
/**
* File: array_stack.kt
* Created Time: 2024-01-25
* Author: curtishd (1023632660@qq.com)
*/
package chapter_stack_and_queue
/* 配列ベースのスタック */
class ArrayStack {
// リスト(動的配列)を初期化する
private val stack = mutableListOf<Int>()
/* スタックの長さを取得 */
fun size(): Int {
return stack.size
}
/* スタックが空かどうかを判定 */
fun isEmpty(): Boolean {
return size() == 0
}
/* プッシュ */
fun push(num: Int) {
stack.add(num)
}
/* ポップ */
fun pop(): Int {
if (isEmpty()) throw IndexOutOfBoundsException()
return stack.removeAt(size() - 1)
}
/* スタックトップの要素にアクセス */
fun peek(): Int {
if (isEmpty()) throw IndexOutOfBoundsException()
return stack[size() - 1]
}
/* List を Array に変換して返す */
fun toArray(): Array<Any> {
return stack.toTypedArray()
}
}
/* Driver Code */
fun main() {
/* スタックを初期化 */
val stack = ArrayStack()
/* 要素をプッシュ */
stack.push(1)
stack.push(3)
stack.push(2)
stack.push(5)
stack.push(4)
println("スタック stack = ${stack.toArray().contentToString()}")
/* スタックトップの要素にアクセス */
val peek = stack.peek()
println("スタックトップ要素 peek = $peek")
/* 要素をポップ */
val pop = stack.pop()
println("ポップした要素 pop = $pop、ポップ後の stack = ${stack.toArray().contentToString()}")
/* スタックの長さを取得 */
val size = stack.size()
println("スタックの長さ size = $size")
/* 空かどうかを判定 */
val isEmpty = stack.isEmpty()
println("スタックが空かどうか = $isEmpty")
}
@@ -0,0 +1,45 @@
/**
* File: deque.kt
* Created Time: 2024-01-25
* Author: curtishd (1023632660@qq.com)
*/
package chapter_stack_and_queue
import java.util.*
/* Driver Code */
fun main() {
/* 両端キューを初期化 */
val deque = LinkedList<Int>()
deque.offerLast(3)
deque.offerLast(2)
deque.offerLast(5)
println("両端キュー deque = $deque")
/* 要素にアクセス */
val peekFirst = deque.peekFirst()
println("先頭要素 peekFirst = $peekFirst")
val peekLast = deque.peekLast()
println("末尾要素 peekLast = $peekLast")
/* 要素をエンキュー */
deque.offerLast(4)
println("要素 4 を末尾に追加後 deque = $deque")
deque.offerFirst(1)
println("要素 1 を先頭に追加後 deque = $deque")
/* 要素をデキュー */
val popLast = deque.pollLast()
println("末尾から取り出した要素 = $popLast、取り出し後 deque = $deque")
val popFirst = deque.pollFirst()
println("先頭から取り出した要素 = $popFirst、取り出し後 deque = $deque")
/* 両端キューの長さを取得 */
val size = deque.size
println("双方向キューの長さ size = $size")
/* 両端キューが空かどうかを判定 */
val isEmpty = deque.isEmpty()
println("双方向キューが空かどうか = $isEmpty")
}
@@ -0,0 +1,163 @@
/**
* File: linkedlist_deque.kt
* Created Time: 2024-01-25
* Author: curtishd (1023632660@qq.com)
*/
package chapter_stack_and_queue
/* 双方向連結リストノード */
class ListNode(var _val: Int) {
// ノード値
var next: ListNode? = null // 後続ノードへの参照
var prev: ListNode? = null // 前駆ノードへの参照
}
/* 双方向連結リストベースの両端キュー */
class LinkedListDeque {
private var front: ListNode? = null // 先頭ノード front
private var rear: ListNode? = null // 末尾ノード rear
private var queSize: Int = 0 // 両端キューの長さ
/* 両端キューの長さを取得 */
fun size(): Int {
return queSize
}
/* 両端キューが空かどうかを判定 */
fun isEmpty(): Boolean {
return size() == 0
}
/* エンキュー操作 */
fun push(num: Int, isFront: Boolean) {
val node = ListNode(num)
// 連結リストが空なら、front と rear の両方を node に向ける
if (isEmpty()) {
rear = node
front = rear
// 先頭へのエンキュー操作
} else if (isFront) {
// node を連結リストの先頭に追加
front?.prev = node
node.next = front
front = node // 先頭ノードを更新する
// 末尾へのエンキュー操作
} else {
// node を連結リストの末尾に追加
rear?.next = node
node.prev = rear
rear = node // 末尾ノードを更新する
}
queSize++ // キューの長さを更新
}
/* キュー先頭にエンキュー */
fun pushFirst(num: Int) {
push(num, true)
}
/* キュー末尾にエンキュー */
fun pushLast(num: Int) {
push(num, false)
}
/* デキュー操作 */
fun pop(isFront: Boolean): Int {
if (isEmpty())
throw IndexOutOfBoundsException()
val _val: Int
// キュー先頭からの取り出し
if (isFront) {
_val = front!!._val // 先頭ノードの値を一時保存
// 先頭ノードを削除
val fNext = front!!.next
if (fNext != null) {
fNext.prev = null
front!!.next = null
}
front = fNext // 先頭ノードを更新する
// キュー末尾からの取り出し
} else {
_val = rear!!._val // 末尾ノードの値を一時保存
// 末尾ノードを削除
val rPrev = rear!!.prev
if (rPrev != null) {
rPrev.next = null
rear!!.prev = null
}
rear = rPrev // 末尾ノードを更新する
}
queSize-- // キューの長さを更新
return _val
}
/* キュー先頭からデキュー */
fun popFirst(): Int {
return pop(true)
}
/* キュー末尾からデキュー */
fun popLast(): Int {
return pop(false)
}
/* キュー先頭の要素にアクセス */
fun peekFirst(): Int {
if (isEmpty()) throw IndexOutOfBoundsException()
return front!!._val
}
/* キュー末尾の要素にアクセス */
fun peekLast(): Int {
if (isEmpty()) throw IndexOutOfBoundsException()
return rear!!._val
}
/* 出力用の配列を返す */
fun toArray(): IntArray {
var node = front
val res = IntArray(size())
for (i in res.indices) {
res[i] = node!!._val
node = node.next
}
return res
}
}
/* Driver Code */
fun main() {
/* 両端キューを初期化 */
val deque = LinkedListDeque()
deque.pushLast(3)
deque.pushLast(2)
deque.pushLast(5)
println("双方向キュー deque = ${deque.toArray().contentToString()}")
/* 要素にアクセス */
val peekFirst = deque.peekFirst()
println("先頭要素 peekFirst = $peekFirst")
val peekLast = deque.peekLast()
println("末尾要素 peekLast = $peekLast")
/* 要素をエンキュー */
deque.pushLast(4)
println("要素 4 を末尾に追加した後 deque = ${deque.toArray().contentToString()}")
deque.pushFirst(1)
println("要素 1 を先頭に追加した後 deque = ${deque.toArray().contentToString()}")
/* 要素をデキュー */
val popLast = deque.popLast()
println("末尾から取り出した要素 = ${popLast}、末尾から取り出した後 deque = ${deque.toArray().contentToString()}")
val popFirst = deque.popFirst()
println("先頭から取り出した要素 = ${popFirst}、先頭から取り出した後 deque = ${deque.toArray().contentToString()}")
/* 両端キューの長さを取得 */
val size = deque.size()
println("双方向キューの長さ size = $size")
/* 両端キューが空かどうかを判定 */
val isEmpty = deque.isEmpty()
println("双方向キューが空かどうか = $isEmpty")
}
@@ -0,0 +1,98 @@
/**
* File: linkedlist_queue.kt
* Created Time: 2024-01-25
* Author: curtishd (1023632660@qq.com)
*/
package chapter_stack_and_queue
/* 連結リストベースのキュー */
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
}
}
/* Driver Code */
fun main() {
/* キューを初期化 */
val queue = LinkedListQueue()
/* 要素をエンキュー */
queue.push(1)
queue.push(3)
queue.push(2)
queue.push(5)
queue.push(4)
println("キュー queue = ${queue.toArray().contentToString()}")
/* キュー先頭の要素にアクセス */
val peek = queue.peek()
println("先頭要素 peek = $peek")
/* 要素をデキュー */
val pop = queue.pop()
println("デキューした要素 pop = $pop、デキュー後 queue = ${queue.toArray().contentToString()}")
/* キューの長さを取得 */
val size = queue.size()
println("キューの長さ size = $size")
/* キューが空かどうかを判定 */
val isEmpty = queue.isEmpty()
println("キューが空かどうか = $isEmpty")
}
@@ -0,0 +1,87 @@
/**
* File: linkedlist_stack.kt
* Created Time: 2024-01-25
* Author: curtishd (1023632660@qq.com)
*/
package chapter_stack_and_queue
/* 連結リストベースのスタック */
class LinkedListStack(
private var stackPeek: ListNode? = null, // 先頭ノードをスタックトップとする
private var stkSize: Int = 0 // スタックの長さ
) {
/* スタックの長さを取得 */
fun size(): Int {
return stkSize
}
/* スタックが空かどうかを判定 */
fun isEmpty(): Boolean {
return size() == 0
}
/* プッシュ */
fun push(num: Int) {
val node = ListNode(num)
node.next = stackPeek
stackPeek = node
stkSize++
}
/* ポップ */
fun pop(): Int? {
val num = peek()
stackPeek = stackPeek?.next
stkSize--
return num
}
/* スタックトップの要素にアクセス */
fun peek(): Int? {
if (isEmpty()) throw IndexOutOfBoundsException()
return stackPeek?._val
}
/* List を Array に変換して返す */
fun toArray(): IntArray {
var node = stackPeek
val res = IntArray(size())
for (i in res.size - 1 downTo 0) {
res[i] = node?._val!!
node = node.next
}
return res
}
}
/* Driver Code */
fun main() {
/* スタックを初期化 */
val stack = LinkedListStack()
/* 要素をプッシュ */
stack.push(1)
stack.push(3)
stack.push(2)
stack.push(5)
stack.push(4)
println("スタック stack = ${stack.toArray().contentToString()}")
/* スタックトップの要素にアクセス */
val peek = stack.peek()!!
println("スタックトップ要素 peek = $peek")
/* 要素をポップ */
val pop = stack.pop()!!
println("ポップした要素 pop = $pop、ポップ後の stack = ${stack.toArray().contentToString()}")
/* スタックの長さを取得 */
val size = stack.size()
println("スタックの長さ size = $size")
/* 空かどうかを判定 */
val isEmpty = stack.isEmpty()
println("スタックが空かどうか = $isEmpty")
}
@@ -0,0 +1,39 @@
/**
* File: queue.kt
* Created Time: 2024-01-25
* Author: curtishd (1023632660@qq.com)
*/
package chapter_stack_and_queue
import java.util.*
/* Driver Code */
fun main() {
/* キューを初期化 */
val queue = LinkedList<Int>()
/* 要素をエンキュー */
queue.offer(1)
queue.offer(3)
queue.offer(2)
queue.offer(5)
queue.offer(4)
println("キュー queue = $queue")
/* キュー先頭の要素にアクセス */
val peek = queue.peek()
println("先頭要素 peek = $peek")
/* 要素をデキュー */
val pop = queue.poll()
println("デキューした要素 pop = $pop、デキュー後 queue = $queue")
/* キューの長さを取得 */
val size = queue.size
println("キューの長さ size = $size")
/* キューが空かどうかを判定 */
val isEmpty = queue.isEmpty()
println("キューが空かどうか = $isEmpty")
}
@@ -0,0 +1,39 @@
/**
* File: stack.kt
* Created Time: 2024-01-25
* Author: curtishd (1023632660@qq.com)
*/
package chapter_stack_and_queue
import java.util.*
/* Driver Code */
fun main() {
/* スタックを初期化 */
val stack = Stack<Int>()
/* 要素をプッシュ */
stack.push(1)
stack.push(3)
stack.push(2)
stack.push(5)
stack.push(4)
println("スタック stack = $stack")
/* スタックトップの要素にアクセス */
val peek = stack.peek()
println("スタックトップ要素 peek = $peek")
/* 要素をポップ */
val pop = stack.pop()
println("ポップした要素 pop = $pop、ポップ後 stack = $stack")
/* スタックの長さを取得 */
val size = stack.size
println("スタックの長さ size = $size")
/* 空かどうかを判定 */
val isEmpty = stack.isEmpty()
println("スタックが空かどうか = $isEmpty")
}