Re-translate the Japanese version (#1871)

* Retranslate Japanese docs with GPT-5.4

* Retranslate Japanese code with GPT-5.4

ja/codes/go/pkg/list_node.go

@@ -0,0 +1,31 @@
+// File: list_node.go
+// Created Time: 2022-11-25
+// Author: Reanon (793584285@qq.com)
+
+package pkg
+
+// ListNode は連結リストノード
+type ListNode struct {
+	Next *ListNode
+	Val  int
+}
+
+// NewListNode は連結リストノードのコンストラクタ
+func NewListNode(v int) *ListNode {
+	return &ListNode{
+		Next: nil,
+		Val:  v,
+	}
+}
+
+// ArrayToLinkedList は配列を連結リストにデシリアライズする
+func ArrayToLinkedList(arr []int) *ListNode {
+	// dummy header of linked list
+	dummy := NewListNode(0)
+	node := dummy
+	for _, val := range arr {
+		node.Next = NewListNode(val)
+		node = node.Next
+	}
+	return dummy.Next
+}

ja/codes/go/pkg/list_node_test.go

@@ -0,0 +1,16 @@
+// File: list_node_test.go
+// Created Time: 2022-11-25
+// Author: Reanon (793584285@qq.com)
+
+package pkg
+
+import (
+	"testing"
+)
+
+func TestListNode(t *testing.T) {
+	arr := []int{2, 3, 5, 6, 7}
+	head := ArrayToLinkedList(arr)
+
+	PrintLinkedList(head)
+}

ja/codes/go/pkg/print_utils.go

@@ -0,0 +1,118 @@
+// File: print_utils.go
+// Created Time: 2022-12-03
+// Author: Reanon (793584285@qq.com), krahets (krahets@163.com), msk397 (machangxinq@gmail.com)
+
+package pkg
+
+import (
+	"container/list"
+	"fmt"
+	"strconv"
+	"strings"
+)
+
+// PrintSlice はスライスを出力する
+func PrintSlice[T any](nums []T) {
+	fmt.Printf("%v", nums)
+	fmt.Println()
+}
+
+// PrintList はリストを出力する
+func PrintList(list *list.List) {
+	if list.Len() == 0 {
+		fmt.Print("[]\n")
+		return
+	}
+	e := list.Front()
+	// string への強制変換は効率に影響する
+	fmt.Print("[")
+	for e.Next() != nil {
+		fmt.Print(e.Value, " ")
+		e = e.Next()
+	}
+	fmt.Print(e.Value, "]\n")
+}
+
+// PrintMap はハッシュテーブルを出力する
+func PrintMap[K comparable, V any](m map[K]V) {
+	for key, value := range m {
+		fmt.Println(key, "->", value)
+	}
+}
+
+// PrintHeap はヒープを出力する
+func PrintHeap(h []any) {
+	fmt.Printf("ヒープの配列表現：")
+	fmt.Printf("%v", h)
+	fmt.Printf("\nヒープの木構造表示：\n")
+	root := SliceToTree(h)
+	PrintTree(root)
+}
+
+// PrintLinkedList は連結リストを出力する
+func PrintLinkedList(node *ListNode) {
+	if node == nil {
+		return
+	}
+	var builder strings.Builder
+	for node.Next != nil {
+		builder.WriteString(strconv.Itoa(node.Val) + " -> ")
+		node = node.Next
+	}
+	builder.WriteString(strconv.Itoa(node.Val))
+	fmt.Println(builder.String())
+}
+
+// PrintTree は二分木を出力する
+func PrintTree(root *TreeNode) {
+	printTreeHelper(root, nil, false)
+}
+
+// printTreeHelper は二分木を出力する
+// This tree printer is borrowed from TECHIE DELIGHT
+// https://www.techiedelight.com/c-program-print-binary-tree/
+func printTreeHelper(root *TreeNode, prev *trunk, isRight bool) {
+	if root == nil {
+		return
+	}
+	prevStr := "    "
+	trunk := newTrunk(prev, prevStr)
+	printTreeHelper(root.Right, trunk, true)
+	if prev == nil {
+		trunk.str = "———"
+	} else if isRight {
+		trunk.str = "/———"
+		prevStr = "   |"
+	} else {
+		trunk.str = "\\———"
+		prev.str = prevStr
+	}
+	showTrunk(trunk)
+	fmt.Println(root.Val)
+	if prev != nil {
+		prev.str = prevStr
+	}
+	trunk.str = "   |"
+	printTreeHelper(root.Left, trunk, false)
+}
+
+type trunk struct {
+	prev *trunk
+	str  string
+}
+
+func newTrunk(prev *trunk, str string) *trunk {
+	return &trunk{
+		prev: prev,
+		str:  str,
+	}
+}
+
+func showTrunk(t *trunk) {
+	if t == nil {
+		return
+	}
+
+	showTrunk(t.prev)
+	fmt.Print(t.str)
+}

ja/codes/go/pkg/tree_node.go

@@ -0,0 +1,78 @@
+// File: tree_node.go
+// Created Time: 2022-11-25
+// Author: Reanon (793584285@qq.com)
+
+package pkg
+
+// TreeNode は二分木ノード
+type TreeNode struct {
+	Val    any       // ノード値
+	Height int       // ノードの高さ
+	Left   *TreeNode // 左子ノードへの参照
+	Right  *TreeNode // 右子ノードへの参照
+}
+
+// NewTreeNode は二分木ノードのコンストラクタ
+func NewTreeNode(v any) *TreeNode {
+	return &TreeNode{
+		Val:    v,
+		Height: 0,
+		Left:   nil,
+		Right:  nil,
+	}
+}
+
+// シリアライズの符号化規則は次を参照してください:
+// https://www.hello-algo.com/chapter_tree/array_representation_of_tree/
+// 二分木の配列表現:
+// [1, 2, 3, 4, nil, 6, 7, 8, 9, nil, nil, 12, nil, nil, 15]
+// 二分木の連結リスト表現:
+//
+// /——— 15
+// /——— 7
+// /——— 3
+// |    \\——— 6
+// |        \\——— 12
+//
+// ——— 1
+//
+// \\——— 2
+// |    /——— 9
+// \\——— 4
+// \\——— 8
+
+// SliceToTreeDFS はリストを二分木にデシリアライズする：再帰
+func SliceToTreeDFS(arr []any, i int) *TreeNode {
+	if i < 0 || i >= len(arr) || arr[i] == nil {
+		return nil
+	}
+	root := NewTreeNode(arr[i])
+	root.Left = SliceToTreeDFS(arr, 2*i+1)
+	root.Right = SliceToTreeDFS(arr, 2*i+2)
+	return root
+}
+
+// SliceToTree はスライスを二分木にデシリアライズする
+func SliceToTree(arr []any) *TreeNode {
+	return SliceToTreeDFS(arr, 0)
+}
+
+// TreeToSliceDFS は二分木をスライスにシリアライズする：再帰
+func TreeToSliceDFS(root *TreeNode, i int, res *[]any) {
+	if root == nil {
+		return
+	}
+	for i >= len(*res) {
+		*res = append(*res, nil)
+	}
+	(*res)[i] = root.Val
+	TreeToSliceDFS(root.Left, 2*i+1, res)
+	TreeToSliceDFS(root.Right, 2*i+2, res)
+}
+
+// TreeToSlice は二分木をスライスにシリアライズする
+func TreeToSlice(root *TreeNode) []any {
+	var res []any
+	TreeToSliceDFS(root, 0, &res)
+	return res
+}

ja/codes/go/pkg/tree_node_test.go

@@ -0,0 +1,21 @@
+// File: tree_node_test.go
+// Created Time: 2022-11-25
+// Author: Reanon (793584285@qq.com)
+
+package pkg
+
+import (
+	"fmt"
+	"testing"
+)
+
+func TestTreeNode(t *testing.T) {
+	arr := []any{1, 2, 3, nil, 5, 6, nil}
+	node := SliceToTree(arr)
+
+	// print tree
+	PrintTree(node)
+
+	// tree to arr
+	fmt.Println(TreeToSlice(node))
+}

ja/codes/go/pkg/vertex.go

@@ -0,0 +1,55 @@
+// File: vertex.go
+// Created Time: 2023-02-18
+// Author: Reanon (793584285@qq.com)
+
+package pkg
+
+// Vertex は頂点クラス
+type Vertex struct {
+	Val int
+}
+
+// NewVertex は頂点のコンストラクタ
+func NewVertex(val int) Vertex {
+	return Vertex{
+		Val: val,
+	}
+}
+
+// ValsToVets は値リストを頂点リストにデシリアライズする
+func ValsToVets(vals []int) []Vertex {
+	vets := make([]Vertex, len(vals))
+	for i := 0; i < len(vals); i++ {
+		vets[i] = NewVertex(vals[i])
+	}
+	return vets
+}
+
+// VetsToVals は頂点リストを値リストにシリアライズする
+func VetsToVals(vets []Vertex) []int {
+	vals := make([]int, len(vets))
+	for i := range vets {
+		vals[i] = vets[i].Val
+	}
+	return vals
+}
+
+// DeleteSliceElms はスライスの指定要素を削除する
+func DeleteSliceElms[T any](a []T, elms ...T) []T {
+	if len(a) == 0 || len(elms) == 0 {
+		return a
+	}
+	// まず要素を set に変換する
+	m := make(map[any]struct{})
+	for _, v := range elms {
+		m[v] = struct{}{}
+	}
+	// 指定した要素を除外する
+	res := make([]T, 0, len(a))
+	for _, v := range a {
+		if _, ok := m[v]; !ok {
+			res = append(res, v)
+		}
+	}
+	return res
+}