Merge branch 'master' into master

Author: krahets

.github/pull_request_template.md

@@ -1,7 +1,5 @@
-> Tip: If this PR is not related to the coding or code translation, please ignore the checklist.
+If this PR is related to coding or code translation, please fill out the checklist.
 
-### Checklist
-
-- [] I've tested the code and ensured the outputs are the same as the outputs of reference codes.
-- [] I've checked the codes (formatting, comments, indentation, file header, etc) carefully.
-- [] The code is not relied on a particular environment or IDE and can be runned on a common system (Win, MacOS, Ubuntu).
+- [ ] I've tested the code and ensured the outputs are the same as the outputs of reference codes.
+- [ ] I've checked the codes (formatting, comments, indentation, file header, etc) carefully.
+- [ ] The code does not rely on a particular environment or IDE and can be executed on a standard system (Win, macOS, Ubuntu).

.gitignore

@@ -13,3 +13,6 @@ docs/overrides/
 
 # python files
 __pycache__
+
+# iml
+hello-algo.iml

README.md

@@ -36,7 +36,7 @@
 - 开源免费，所有同学都可在网上获取本书；
 - 新手友好，适合算法初学者自主学习入门；
 - 动画讲解，尽可能地保证平滑的学习曲线；
-- 代码导向，提供精简、可运行的算法代码；
+- 代码导向，提供可一键运行的算法源代码；
 - 讨论学习，提问一般能在三日内得到回复；
 
 如果感觉本书对你有所帮助，请点个 Star :star: 支持一下，谢谢！

codes/cpp/chapter_array_and_linkedlist/array.cpp

@@ -30,7 +30,7 @@ int* extend(int* nums, int size, int enlarge) {
 /* 在数组的索引 index 处插入元素 num */
 void insert(int* nums, int size, int num, int index) {
     // 把索引 index 以及之后的所有元素向后移动一位
-    for (int i = size - 1; i >= index; i--) {
+    for (int i = size - 1; i > index; i--) {
         nums[i] = nums[i - 1];
     }
     // 将 num 赋给 index 处元素

codes/cpp/chapter_sorting/merge_sort.cpp

@@ -22,13 +22,13 @@ void merge(vector<int>& nums, int left, int mid, int right) {
     int i = leftStart, j = rightStart;                
     // 通过覆盖原数组 nums 来合并左子数组和右子数组
     for (int k = left; k <= right; k++) {
-        // 若 “左子数组已全部合并完”，则选取右子数组元素，并且 j++
+        // 若“左子数组已全部合并完”，则选取右子数组元素，并且 j++
         if (i > leftEnd)
             nums[k] = tmp[j++];
-        // 否则，若 “右子数组已全部合并完” 或 “左子数组元素 < 右子数组元素”，则选取左子数组元素，并且 i++
+        // 否则，若“右子数组已全部合并完”或“左子数组元素 < 右子数组元素”，则选取左子数组元素，并且 i++
         else if (j > rightEnd || tmp[i] <= tmp[j])
             nums[k] = tmp[i++];
-        // 否则，若 “左子数组元素 > 右子数组元素”，则选取右子数组元素，并且 j++
+        // 否则，若“左子数组元素 > 右子数组元素”，则选取右子数组元素，并且 j++
         else
             nums[k] = tmp[j++];
     }

codes/cpp/chapter_stack_and_queue/array_queue.cpp

@@ -59,19 +59,11 @@ class ArrayQueue {
 
     /* 访问队首元素 */
     int peek() {
-        // 删除头结点
         if (empty())
             throw out_of_range("队列为空");
         return nums[front];
     }
 
-    /* 访问指定索引元素 */
-    int get(int index) {
-        if (index >= size())
-            throw out_of_range("索引越界");
-        return nums[(front + index) % capacity()];
-    }
-
     /* 将数组转化为 Vector 并返回 */
     vector<int> toVector() {
         int siz = size();
@@ -104,11 +96,7 @@ int main() {
     /* 访问队首元素 */
     int peek = queue->peek();
     cout << "队首元素 peek = " << peek << endl;
-
-    /* 访问指定索引元素 */
-    int num = queue->get(2);
-    cout << "队列第 3 个元素为 num = " << num << endl;
-
+    
     /* 元素出队 */
     int poll = queue->poll();
     cout << "出队元素 poll = " << poll << "，出队后 queue = ";

codes/cpp/chapter_stack_and_queue/array_stack.cpp

@@ -29,21 +29,18 @@ class ArrayStack {
 
     /* 出栈 */
     int pop() {
-        int oldTop = stack.back();
+        int oldTop = top();
         stack.pop_back();
         return oldTop;
     }
 
     /* 访问栈顶元素 */
     int top() {
+        if(empty())
+            throw out_of_range("栈为空");
         return stack.back();
     }
 
-    /* 访问索引 index 处元素 */
-    int get(int index) {
-        return stack[index];
-    }
-
     /* 返回 Vector */
     vector<int> toVector() {
         return stack;
@@ -69,10 +66,6 @@ int main() {
     int top = stack->top();
     cout << "栈顶元素 top = " << top << endl;
 
-    /* 访问索引 index 处元素 */
-    int num = stack->get(3);
-    cout << "栈索引 3 处的元素为 num = " << num << endl;
-
     /* 元素出栈 */
     int pop = stack->pop();
     cout << "出栈元素 pop = " << pop << "，出栈后 stack = ";

codes/csharp/chapter_array_and_linkedlist/Array.cs renamed to codes/csharp/chapter_array_and_linkedlist/array.cs

@@ -1,4 +1,4 @@
-// File: Array.cs
+// File: array.cs
 // Created Time: 2022-12-14
 // Author: mingXta ([email protected])
 
@@ -41,7 +41,7 @@ public static int[] Extend(int[] nums, int enlarge)
         public static void Insert(int[] nums, int num, int index)
         {
             // 把索引 index 以及之后的所有元素向后移动一位
-            for (int i = nums.Length - 1; i >= index; i--)
+            for (int i = nums.Length - 1; i > index; i--)
             {
                 nums[i] = nums[i - 1];
             }
@@ -134,4 +134,4 @@ public static void Test()
             Console.WriteLine("在 nums 中查找元素 3 ，得到索引 = " + index);
         }
     }
-}
+}

codes/csharp/chapter_array_and_linkedlist/LinkedList.cs renamed to codes/csharp/chapter_array_and_linkedlist/linked_list.cs

@@ -1,4 +1,4 @@
-// File: LinkedList.cs
+// File: linked_list.cs
 // Created Time: 2022-12-16
 // Author: mingXta ([email protected])
 
@@ -7,14 +7,14 @@
 
 namespace hello_algo.chapter_array_and_linkedlist
 {
-    public class LinkedList
+    public class linked_list
     {
         /// <summary>
         /// 在链表的结点 n0 之后插入结点 P
         /// </summary>
         public static void Insert(ListNode n0, ListNode P)
         {
-            ListNode n1 = n0.next;
+            ListNode? n1 = n0.next;
             n0.next = P;
             P.next = n1;
         }
@@ -28,14 +28,14 @@ public static void Remove(ListNode n0)
                 return;
             // n0 -> P -> n1
             ListNode P = n0.next;
-            ListNode n1 = P.next;
+            ListNode? n1 = P.next;
             n0.next = n1;
         }
 
         /// <summary>
         /// 访问链表中索引为 index 的结点
         /// </summary>
-        public static ListNode Access(ListNode head, int index)
+        public static ListNode? Access(ListNode head, int index)
         {
             for (int i = 0; i < index; i++)
             {
@@ -89,12 +89,12 @@ public void Test()
             Console.WriteLine($"删除结点后的链表为{n0}");
 
             // 访问结点 
-            ListNode node = Access(n0, 3);
-            Console.WriteLine($"链表中索引 3 处的结点的值 = {node.val}");
+            ListNode? node = Access(n0, 3);
+            Console.WriteLine($"链表中索引 3 处的结点的值 = {node?.val}");
 
             // 查找结点 
             int index = Find(n0, 2);
             Console.WriteLine($"链表中值为 2 的结点的索引 = {index}");    
         }
     }
-}
+}

codes/csharp/chapter_array_and_linkedlist/list.cs

@@ -0,0 +1,75 @@
+/**
+ * File: list.cs
+ * Created Time: 2022-12-23
+ * Author: haptear ([email protected])
+ */
+
+using NUnit.Framework;
+
+namespace hello_algo.chapter_array_and_linkedlist
+{
+    public class list
+    {
+        [Test]
+        public void Test()
+        {
+
+            /* 初始化列表 */
+            // 注意数组的元素类型是 int[] 的包装类 int[]
+            int[] numbers = new int[] { 1, 3, 2, 5, 4 };
+            List<int> list = numbers.ToList();
+            Console.WriteLine("列表 list = " + string.Join(",",list));
+
+            /* 访问元素 */
+            int num = list[1];
+            Console.WriteLine("访问索引 1 处的元素，得到 num = " + num);
+
+            /* 更新元素 */
+            list[1] = 0;
+            Console.WriteLine("将索引 1 处的元素更新为 0 ，得到 list = " + string.Join(",", list));
+
+            /* 清空列表 */
+            list.Clear();
+            Console.WriteLine("清空列表后 list = " + string.Join(",", list));
+
+            /* 尾部添加元素 */
+            list.Add(1);
+            list.Add(3);
+            list.Add(2);
+            list.Add(5);
+            list.Add(4);
+            Console.WriteLine("添加元素后 list = " + string.Join(",", list));
+
+            /* 中间插入元素 */
+            list.Insert(3, 6);
+            Console.WriteLine("在索引 3 处插入数字 6 ，得到 list = " + string.Join(",", list));
+
+            /* 删除元素 */
+            list.RemoveAt(3);
+            Console.WriteLine("删除索引 3 处的元素，得到 list = " + string.Join(",", list));
+
+            /* 通过索引遍历列表 */
+            int count = 0;
+            for (int i = 0; i < list.Count(); i++)
+            {
+                count++;
+            }
+
+            /* 直接遍历列表元素 */
+            count = 0;
+            foreach (int n in list)
+            {
+                count++;
+            }
+
+            /* 拼接两个列表 */
+            List<int> list1 = new() { 6, 8, 7, 10, 9 };
+            list.AddRange(list1);
+            Console.WriteLine("将列表 list1 拼接到 list 之后，得到 list = " + string.Join(",", list));
+
+            /* 排序列表 */
+            list.Sort(); // 排序后，列表元素从小到大排列
+            Console.WriteLine("排序列表后 list = " + string.Join(",", list));
+        }
+    }
+}