Re-translate the Japanese version (#1871)

* Retranslate Japanese docs with GPT-5.4

* Retranslate Japanese code with GPT-5.4

ja/codes/csharp/utils/ListNode.cs

@@ -0,0 +1,32 @@
+// File: ListNode.cs
+// Created Time: 2022-12-16
+// Author: mingXta (1195669834@qq.com)
+
+namespace hello_algo.utils;
+
+/* 連結リストノード */
+public class ListNode(int x) {
+    public int val = x;
+    public ListNode? next;
+
+    /* 配列をデシリアライズして連結リストに変換する */
+    public static ListNode? ArrToLinkedList(int[] arr) {
+        ListNode dum = new(0);
+        ListNode head = dum;
+        foreach (int val in arr) {
+            head.next = new ListNode(val);
+            head = head.next;
+        }
+        return dum.next;
+    }
+
+    public override string? ToString() {
+        List<string> list = [];
+        var head = this;
+        while (head != null) {
+            list.Add(head.val.ToString());
+            head = head.next;
+        }
+        return string.Join("->", list);
+    }
+}

ja/codes/csharp/utils/PrintUtil.cs

@@ -0,0 +1,132 @@
+/**
+* File: PrintUtil.cs
+* Created Time: 2022-12-23
+* Author: haptear (haptear@hotmail.com), krahets (krahets@163.com)
+*/
+
+namespace hello_algo.utils;
+
+public class Trunk(Trunk? prev, string str) {
+    public Trunk? prev = prev;
+    public string str = str;
+};
+
+public static class PrintUtil {
+    /* リストを出力する */
+    public static void PrintList<T>(IList<T> list) {
+        Console.WriteLine("[" + string.Join(", ", list) + "]");
+    }
+
+    public static string PrintList<T>(this IEnumerable<T?> list) {
+        return $"[ {string.Join(", ", list.Select(x => x?.ToString() ?? "null"))} ]";
+    }
+
+    /* 行列を出力する (Array) */
+    public static void PrintMatrix<T>(T[][] matrix) {
+        Console.WriteLine("[");
+        foreach (T[] row in matrix) {
+            Console.WriteLine("  " + string.Join(", ", row) + ",");
+        }
+        Console.WriteLine("]");
+    }
+
+    /* 行列を出力 (List) */
+    public static void PrintMatrix<T>(List<List<T>> matrix) {
+        Console.WriteLine("[");
+        foreach (List<T> row in matrix) {
+            Console.WriteLine("  " + string.Join(", ", row) + ",");
+        }
+        Console.WriteLine("]");
+    }
+
+    /* 連結リストを出力 */
+    public static void PrintLinkedList(ListNode? head) {
+        List<string> list = [];
+        while (head != null) {
+            list.Add(head.val.ToString());
+            head = head.next;
+        }
+        Console.Write(string.Join(" -> ", list));
+    }
+
+    /**
+ * 二分木を出力
+ * This tree printer is borrowed from TECHIE DELIGHT
+ * https://www.techiedelight.com/c-program-print-binary-tree/
+ */
+    public static void PrintTree(TreeNode? root) {
+        PrintTree(root, null, false);
+    }
+
+    /* 二分木を出力 */
+    public static void PrintTree(TreeNode? root, Trunk? prev, bool isRight) {
+        if (root == null) {
+            return;
+        }
+
+        string prev_str = "    ";
+        Trunk trunk = new(prev, prev_str);
+
+        PrintTree(root.right, trunk, true);
+
+        if (prev == null) {
+            trunk.str = "———";
+        } else if (isRight) {
+            trunk.str = "/———";
+            prev_str = "   |";
+        } else {
+            trunk.str = "\\———";
+            prev.str = prev_str;
+        }
+
+        ShowTrunks(trunk);
+        Console.WriteLine(" " + root.val);
+
+        if (prev != null) {
+            prev.str = prev_str;
+        }
+        trunk.str = "   |";
+
+        PrintTree(root.left, trunk, false);
+    }
+
+    public static void ShowTrunks(Trunk? p) {
+        if (p == null) {
+            return;
+        }
+
+        ShowTrunks(p.prev);
+        Console.Write(p.str);
+    }
+
+    /* ハッシュテーブルを出力 */
+    public static void PrintHashMap<K, V>(Dictionary<K, V> map) where K : notnull {
+        foreach (var kv in map.Keys) {
+            Console.WriteLine(kv.ToString() + " -> " + map[kv]?.ToString());
+        }
+    }
+
+    /* ヒープを出力 */
+    public static void PrintHeap(Queue<int> queue) {
+        Console.Write("ヒープの配列表現：");
+        List<int> list = [.. queue];
+        Console.WriteLine(string.Join(',', list));
+        Console.WriteLine("ヒープの木構造表示：");
+        TreeNode? tree = TreeNode.ListToTree(list.Cast<int?>().ToList());
+        PrintTree(tree);
+    }
+
+    /* 優先キューを出力 */
+    public static void PrintHeap(PriorityQueue<int, int> queue) {
+        var newQueue = new PriorityQueue<int, int>(queue.UnorderedItems, queue.Comparer);
+        Console.Write("ヒープの配列表現：");
+        List<int> list = [];
+        while (newQueue.TryDequeue(out int element, out _)) {
+            list.Add(element);
+        }
+        Console.WriteLine("ヒープの木構造表示：");
+        Console.WriteLine(string.Join(',', list.ToList()));
+        TreeNode? tree = TreeNode.ListToTree(list.Cast<int?>().ToList());
+        PrintTree(tree);
+    }
+}

ja/codes/csharp/utils/TreeNode.cs

@@ -0,0 +1,67 @@
+/**
+ * File: TreeNode.cs
+ * Created Time: 2022-12-23
+ * Author: haptear (haptear@hotmail.com)
+ */
+
+namespace hello_algo.utils;
+
+/* 二分木ノードクラス */
+public class TreeNode(int? x) {
+    public int? val = x;    // ノード値
+    public int height;      // ノードの高さ
+    public TreeNode? left;  // 左子ノードへの参照
+    public TreeNode? right; // 右子ノードへの参照
+
+    // シリアライズの符号化規則は以下を参照:
+    // https://www.hello-algo.com/chapter_tree/array_representation_of_tree/
+    // 二分木の配列表現:
+    // [1, 2, 3, 4, None, 6, 7, 8, 9, None, None, 12, None, None, 15]
+    // 二分木の連結リスト表現:
+    // /——— 15
+    // /——— 7
+    // /——— 3
+    // |    \——— 6
+    // |        \——— 12
+    // ——— 1
+    // \——— 2
+    // |    /——— 9
+    // \——— 4
+    // \——— 8
+
+    /* リストを二分木にデシリアライズする: 再帰 */
+    static TreeNode? ListToTreeDFS(List<int?> arr, int i) {
+        if (i < 0 || i >= arr.Count || !arr[i].HasValue) {
+            return null;
+        }
+        TreeNode root = new(arr[i]) {
+            left = ListToTreeDFS(arr, 2 * i + 1),
+            right = ListToTreeDFS(arr, 2 * i + 2)
+        };
+        return root;
+    }
+
+    /* リストを二分木にデシリアライズする */
+    public static TreeNode? ListToTree(List<int?> arr) {
+        return ListToTreeDFS(arr, 0);
+    }
+
+    /* 二分木をリストにシリアライズする: 再帰 */
+    static void TreeToListDFS(TreeNode? root, int i, List<int?> res) {
+        if (root == null)
+            return;
+        while (i >= res.Count) {
+            res.Add(null);
+        }
+        res[i] = root.val;
+        TreeToListDFS(root.left, 2 * i + 1, res);
+        TreeToListDFS(root.right, 2 * i + 2, res);
+    }
+
+    /* 二分木をリストにシリアライズする */
+    public static List<int?> TreeToList(TreeNode root) {
+        List<int?> res = [];
+        TreeToListDFS(root, 0, res);
+        return res;
+    }
+}

ja/codes/csharp/utils/Vertex.cs

@@ -0,0 +1,30 @@
+/**
+ * File: Vertex.cs
+ * Created Time: 2023-02-06
+ * Author: zjkung1123 (zjkung1123@gmail.com), krahets (krahets@163.com)
+ */
+
+namespace hello_algo.utils;
+
+/* 頂点クラス */
+public class Vertex(int val) {
+    public int val = val;
+
+    /* 値リスト vals を入力し、頂点リスト vets を返す */
+    public static Vertex[] ValsToVets(int[] vals) {
+        Vertex[] vets = new Vertex[vals.Length];
+        for (int i = 0; i < vals.Length; i++) {
+            vets[i] = new Vertex(vals[i]);
+        }
+        return vets;
+    }
+
+    /* 頂点リスト vets を入力し、値リスト vals を返す */
+    public static List<int> VetsToVals(List<Vertex> vets) {
+        List<int> vals = [];
+        foreach (Vertex vet in vets) {
+            vals.Add(vet.val);
+        }
+        return vals;
+    }
+}