Re-translate the Japanese version (#1871)

* Retranslate Japanese docs with GPT-5.4

* Retranslate Japanese code with GPT-5.4

ja/codes/go/chapter_searching/binary_search.go

@@ -0,0 +1,43 @@
+// File: binary_search.go
+// Created Time: 2022-12-05
+// Author: Slone123c (274325721@qq.com)
+
+package chapter_searching
+
+/* 二分探索（両閉区間） */
+func binarySearch(nums []int, target int) int {
+	// 両閉区間 [0, n-1] を初期化する。つまり i, j はそれぞれ配列の先頭要素と末尾要素を指す
+	i, j := 0, len(nums)-1
+	// ループし、探索区間が空になったら終了する（i > j で空）
+	for i <= j {
+		m := i + (j-i)/2      // 中点インデックス m を計算
+		if nums[m] < target { // この場合、target は区間 [m+1, j] にある
+			i = m + 1
+		} else if nums[m] > target { // この場合、target は区間 [i, m-1] にある
+			j = m - 1
+		} else { // 目標要素が見つかったらそのインデックスを返す
+			return m
+		}
+	}
+	// 目標要素が見つからなければ -1 を返す
+	return -1
+}
+
+/* 二分探索（左閉右開区間） */
+func binarySearchLCRO(nums []int, target int) int {
+	// 左閉右開区間 [0, n) を初期化する。つまり i, j はそれぞれ配列の先頭要素と末尾要素+1を指す
+	i, j := 0, len(nums)
+	// ループし、探索区間が空になったら終了する（i = j で空）
+	for i < j {
+		m := i + (j-i)/2      // 中点インデックス m を計算
+		if nums[m] < target { // この場合、target は区間 [m+1, j) にある
+			i = m + 1
+		} else if nums[m] > target { // この場合、target は区間 [i, m) にある
+			j = m
+		} else { // 目標要素が見つかったらそのインデックスを返す
+			return m
+		}
+	}
+	// 目標要素が見つからなければ -1 を返す
+	return -1
+}

ja/codes/go/chapter_searching/binary_search_edge.go

@@ -0,0 +1,31 @@
+// File: binary_search_edge.go
+// Created Time: 2023-08-23
+// Author: Reanon (793584285@qq.com)
+
+package chapter_searching
+
+/* 最も左の target を二分探索 */
+func binarySearchLeftEdge(nums []int, target int) int {
+	// target の挿入位置を探すのと等価
+	i := binarySearchInsertion(nums, target)
+	// target が見つからなければ、-1 を返す
+	if i == len(nums) || nums[i] != target {
+		return -1
+	}
+	// target が見つかったら、インデックス i を返す
+	return i
+}
+
+/* 最も右の target を二分探索 */
+func binarySearchRightEdge(nums []int, target int) int {
+	// 最左の target + 1 を探す問題に変換する
+	i := binarySearchInsertion(nums, target+1)
+	// j は最も右の target を指し、i は target より大きい最初の要素を指す
+	j := i - 1
+	// target が見つからなければ、-1 を返す
+	if j == -1 || nums[j] != target {
+		return -1
+	}
+	// target が見つかったら、インデックス j を返す
+	return j
+}

ja/codes/go/chapter_searching/binary_search_insertion.go

@@ -0,0 +1,49 @@
+// File: binary_search_insertion.go
+// Created Time: 2023-08-23
+// Author: Reanon (793584285@qq.com)
+
+package chapter_searching
+
+/* 二分探索で挿入位置を探す（重複要素なし） */
+func binarySearchInsertionSimple(nums []int, target int) int {
+	// 両閉区間 [0, n-1] を初期化
+	i, j := 0, len(nums)-1
+	for i <= j {
+		// 中点インデックス m を計算
+		m := i + (j-i)/2
+		if nums[m] < target {
+			// target は区間 [m+1, j] にある
+			i = m + 1
+		} else if nums[m] > target {
+			// target は区間 [i, m-1] にある
+			j = m - 1
+		} else {
+			// target が見つかったら、挿入位置 m を返す
+			return m
+		}
+	}
+	// target が見つからなければ、挿入位置 i を返す
+	return i
+}
+
+/* 二分探索で挿入位置を探す（重複要素あり） */
+func binarySearchInsertion(nums []int, target int) int {
+	// 両閉区間 [0, n-1] を初期化
+	i, j := 0, len(nums)-1
+	for i <= j {
+		// 中点インデックス m を計算
+		m := i + (j-i)/2
+		if nums[m] < target {
+			// target は区間 [m+1, j] にある
+			i = m + 1
+		} else if nums[m] > target {
+			// target は区間 [i, m-1] にある
+			j = m - 1
+		} else {
+			// target より小さい最初の要素は区間 [i, m-1] にある
+			j = m - 1
+		}
+	}
+	// 挿入位置 i を返す
+	return i
+}

ja/codes/go/chapter_searching/binary_search_test.go

@@ -0,0 +1,61 @@
+// File: binary_search_test.go
+// Created Time: 2022-12-05
+// Author: Slone123c (274325721@qq.com)
+
+package chapter_searching
+
+import (
+	"fmt"
+	"testing"
+)
+
+func TestBinarySearch(t *testing.T) {
+	var (
+		target   = 6
+		nums     = []int{1, 3, 6, 8, 12, 15, 23, 26, 31, 35}
+		expected = 2
+	)
+	// 配列で二分探索を実行
+	actual := binarySearch(nums, target)
+	fmt.Println("対象要素 6 のインデックス =", actual)
+	if actual != expected {
+		t.Errorf("対象要素 6 のインデックス = %d, 想定値は %d", actual, expected)
+	}
+}
+
+func TestBinarySearchEdge(t *testing.T) {
+	// 重複要素を含む配列
+	nums := []int{1, 3, 6, 8, 12, 15, 23, 26, 31, 35}
+	fmt.Println("\n配列 nums = ", nums)
+
+	// 二分探索で左端と右端を探す
+	for _, target := range []int{6, 7} {
+		index := binarySearchLeftEdge(nums, target)
+		fmt.Println("最も左の要素", target, "のインデックスは", index)
+
+		index = binarySearchRightEdge(nums, target)
+		fmt.Println("最も右の要素", target, "のインデックスは", index)
+	}
+}
+
+func TestBinarySearchInsertion(t *testing.T) {
+	// 重複要素のない配列
+	nums := []int{1, 3, 6, 8, 12, 15, 23, 26, 31, 35}
+	fmt.Println("配列 nums =", nums)
+
+	// 二分探索で挿入位置を探す
+	for _, target := range []int{6, 9} {
+		index := binarySearchInsertionSimple(nums, target)
+		fmt.Println("要素", target, "の挿入位置のインデックスは", index)
+	}
+
+	// 重複要素を含む配列
+	nums = []int{1, 3, 6, 6, 6, 6, 6, 10, 12, 15}
+	fmt.Println("\n配列 nums =", nums)
+
+	// 二分探索で挿入位置を探す
+	for _, target := range []int{2, 6, 20} {
+		index := binarySearchInsertion(nums, target)
+		fmt.Println("要素", target, "の挿入位置のインデックスは", index)
+	}
+}

ja/codes/go/chapter_searching/hashing_search.go

@@ -0,0 +1,29 @@
+// File: hashing_search.go
+// Created Time: 2022-12-12
+// Author: Slone123c (274325721@qq.com)
+
+package chapter_searching
+
+import . "github.com/krahets/hello-algo/pkg"
+
+/* ハッシュ探索（配列） */
+func hashingSearchArray(m map[int]int, target int) int {
+	// ハッシュテーブルの key: 目標要素、value: インデックス
+	// ハッシュテーブルにこの key がなければ -1 を返す
+	if index, ok := m[target]; ok {
+		return index
+	} else {
+		return -1
+	}
+}
+
+/* ハッシュ探索（連結リスト） */
+func hashingSearchLinkedList(m map[int]*ListNode, target int) *ListNode {
+	// ハッシュテーブルの key: 対象ノードの値、value: ノードオブジェクト
+	// ハッシュテーブルにその key がなければ nil を返す
+	if node, ok := m[target]; ok {
+		return node
+	} else {
+		return nil
+	}
+}

ja/codes/go/chapter_searching/hashing_search_test.go

@@ -0,0 +1,36 @@
+// File: hashing_search_test.go
+// Created Time: 2022-12-12
+// Author: Slone123c (274325721@qq.com)
+
+package chapter_searching
+
+import (
+	"fmt"
+	"testing"
+
+	. "github.com/krahets/hello-algo/pkg"
+)
+
+func TestHashingSearch(t *testing.T) {
+	target := 3
+	/* ハッシュ探索（配列） */
+	nums := []int{1, 5, 3, 2, 4, 7, 5, 9, 10, 8}
+	// ハッシュテーブルを初期化
+	m := make(map[int]int)
+	for i := 0; i < len(nums); i++ {
+		m[nums[i]] = i
+	}
+	index := hashingSearchArray(m, target)
+	fmt.Println("対象要素 3 のインデックス = ", index)
+
+	/* ハッシュ探索（連結リスト） */
+	head := ArrayToLinkedList(nums)
+	// ハッシュテーブルを初期化
+	m1 := make(map[int]*ListNode)
+	for head != nil {
+		m1[head.Val] = head
+		head = head.Next
+	}
+	node := hashingSearchLinkedList(m1, target)
+	fmt.Println("対象ノード値 3 に対応するノードオブジェクト = ", node)
+}

ja/codes/go/chapter_searching/linear_search.go

@@ -0,0 +1,36 @@
+// File: linear_search.go
+// Created Time: 2022-11-25
+// Author: Reanon (793584285@qq.com)
+
+package chapter_searching
+
+import (
+	. "github.com/krahets/hello-algo/pkg"
+)
+
+/* 線形探索（配列） */
+func linearSearchArray(nums []int, target int) int {
+	// 配列を走査
+	for i := 0; i < len(nums); i++ {
+		// 目標要素が見つかったらそのインデックスを返す
+		if nums[i] == target {
+			return i
+		}
+	}
+	// 目標要素が見つからなければ -1 を返す
+	return -1
+}
+
+/* 線形探索（連結リスト） */
+func linearSearchLinkedList(node *ListNode, target int) *ListNode {
+	// 連結リストを走査
+	for node != nil {
+		// 対象ノードが見つかったら、それを返す
+		if node.Val == target {
+			return node
+		}
+		node = node.Next
+	}
+	// 対象要素が見つからない場合は `nil` を返す
+	return nil
+}

ja/codes/go/chapter_searching/linear_search_test.go

@@ -0,0 +1,26 @@
+// File: linear_search_test.go
+// Created Time: 2022-11-25
+// Author: Reanon (793584285@qq.com)
+
+package chapter_searching
+
+import (
+	"fmt"
+	"testing"
+
+	. "github.com/krahets/hello-algo/pkg"
+)
+
+func TestLinearSearch(t *testing.T) {
+	target := 3
+	nums := []int{1, 5, 3, 2, 4, 7, 5, 9, 10, 8}
+
+	// 配列で線形探索を行う
+	index := linearSearchArray(nums, target)
+	fmt.Println("対象要素 3 のインデックス =", index)
+
+	// 連結リストで線形探索を行う
+	head := ArrayToLinkedList(nums)
+	node := linearSearchLinkedList(head, target)
+	fmt.Println("対象ノード値 3 に対応するノードオブジェクト =", node)
+}

ja/codes/go/chapter_searching/two_sum.go

@@ -0,0 +1,33 @@
+// File: two_sum.go
+// Created Time: 2022-11-25
+// Author: reanon (793584285@qq.com)
+
+package chapter_searching
+
+/* 方法 1：総当たり列挙 */
+func twoSumBruteForce(nums []int, target int) []int {
+	size := len(nums)
+	// 2重ループのため、時間計算量は O(n^2)
+	for i := 0; i < size-1; i++ {
+		for j := i + 1; j < size; j++ {
+			if nums[i]+nums[j] == target {
+				return []int{i, j}
+			}
+		}
+	}
+	return nil
+}
+
+/* 方法 2：補助ハッシュテーブル */
+func twoSumHashTable(nums []int, target int) []int {
+	// 補助ハッシュテーブルを使用し、空間計算量は O(n)
+	hashTable := map[int]int{}
+	// 単一ループで、時間計算量は O(n)
+	for idx, val := range nums {
+		if preIdx, ok := hashTable[target-val]; ok {
+			return []int{preIdx, idx}
+		}
+		hashTable[val] = idx
+	}
+	return nil
+}

ja/codes/go/chapter_searching/two_sum_test.go

@@ -0,0 +1,24 @@
+// File: two_sum_test.go
+// Created Time: 2022-11-25
+// Author: reanon (793584285@qq.com)
+
+package chapter_searching
+
+import (
+	"fmt"
+	"testing"
+)
+
+func TestTwoSum(t *testing.T) {
+	// ======= Test Case =======
+	nums := []int{2, 7, 11, 15}
+	target := 13
+
+	// ====== Driver Code ======
+	// 方法 1：総当たり法
+	res := twoSumBruteForce(nums, target)
+	fmt.Println("方法1 res =", res)
+	// 方法2: ハッシュテーブル
+	res = twoSumHashTable(nums, target)
+	fmt.Println("方法2 res =", res)
+}