Merge branch 'master' of github.com:krahets/hello-algo

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) / 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 binarySearch1(nums []int, target int) int {
+	// 初始化左闭右开 [0, n) ，即 i, j 分别指向数组首元素、尾元素+1
+	i, j := 0, len(nums)
+	// 循环，当搜索区间为空时跳出（当 i = j 时为空）
+	for i < j {
+		m := (i + j) / 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
+}

codes/go/chapter_searching/binary_search_test.go

@@ -0,0 +1,24 @@
+// 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   = 3
+		nums     = []int{1, 2, 3, 4, 5, 6, 7, 8, 9, 10}
+		expected = 2
+	)
+	// 在数组中执行二分查找
+	actual := binarySearch(nums, target)
+	fmt.Println("目标元素 3 的索引 =", actual)
+	if actual != expected {
+		t.Errorf("目标元素 3 的索引 = %d, 应该为 %d", actual, expected)
+	}
+}

codes/javascript/chapter_stack_and_queue/queue.js

@@ -0,0 +1,30 @@
+/**
+ * File: queue.js
+ * Created Time: 2022-12-05
+ * Author: S-N-O-R-L-A-X (snorlax.xu@outlook.com)
+ */
+
+/* 初始化队列 */
+// JavaScript 没有内置的队列，可以把 Array 当作队列来使用 
+// 注意：由于是数组，所以 shift() 的时间复杂度是 O(n)
+const queue = [];
+
+/* 元素入队 */
+queue.push(1);
+queue.push(3);
+queue.push(2);
+queue.push(5);
+queue.push(4);
+
+/* 访问队首元素 */
+const peek = queue[0];
+
+/* 元素出队 */
+// O(n)
+const poll = queue.shift();
+
+/* 获取队列的长度 */
+const size = queue.length;
+
+/* 判断队列是否为空 */
+const empty = queue.length === 0;

codes/typescript/chapter_stack_and_queue/queue.ts

@@ -0,0 +1,32 @@
+/**
+ * File: queue.ts
+ * Created Time: 2022-12-05
+ * Author: S-N-O-R-L-A-X (snorlax.xu@outlook.com)
+ */
+
+/* 初始化队列 */
+// TypeScript 没有内置的队列，可以把 Array 当作队列来使用 
+// 注意：由于是数组，所以 shift() 的时间复杂度是 O(n)
+const queue: number[] = [];
+
+/* 元素入队 */
+queue.push(1);
+queue.push(3);
+queue.push(2);
+queue.push(5);
+queue.push(4);
+
+/* 访问队首元素 */
+const peek = queue[0];
+
+/* 元素出队 */
+// O(n)
+const poll = queue.shift();
+
+/* 获取队列的长度 */
+const size = queue.length;
+
+/* 判断队列是否为空 */
+const empty = queue.length === 0;
+
+export { };

docs/chapter_searching/binary_search.md

@@ -123,7 +123,24 @@ $$
 === "Go"
 
     ```go title="binary_search.go"
-
+    /* 二分查找（左闭右开） */
+    func binarySearch1(nums []int, target int) int {
+        // 初始化左闭右开 [0, n) ，即 i, j 分别指向数组首元素、尾元素+1
+        i, j := 0, len(nums)
+        // 循环，当搜索区间为空时跳出（当 i = j 时为空）
+        for i < j {
+            m := (i + j) / 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
+    }
     ```
 
 === "JavaScript"
@@ -220,7 +237,24 @@ $$
 === "Go"
 
     ```go title="binary_search.go"
-
+    /* 二分查找（左闭右开） */
+    func binarySearch1(nums []int, target int) int {
+        // 初始化左闭右开 [0, n) ，即 i, j 分别指向数组首元素、尾元素+1
+        i, j := 0, len(nums)
+        // 循环，当搜索区间为空时跳出（当 i = j 时为空）
+        for i < j {
+            m := (i + j) / 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
+    }
     ```
 
 === "JavaScript"
@@ -294,7 +328,10 @@ $$
 === "Go"
 
     ```go title=""
-
+    // (i + j) 有可能超出 int 的取值范围
+    m := (i + j) / 2
+    // 更换为此写法则不会越界
+    m := i + (j - i) / 2
     ```
 
 === "JavaScript"

docs/chapter_stack_and_queue/queue.md

@@ -20,13 +20,13 @@ comments: true
 
 <div class="center-table" markdown>
 
-| 方法      | 描述                      |
+| 方法      | 描述                         |
-| --------- | ------------------------ |
+| --------- | ---------------------------- |
-| offer()   | 元素入队，即将元素添加至队尾  |
+| offer()   | 元素入队，即将元素添加至队尾 |
-| poll()    | 队首元素出队               |
+| poll()    | 队首元素出队                 |
-| front()   | 访问队首元素               |
+| front()   | 访问队首元素                 |
-| size()    | 获取队列的长度             |
+| size()    | 获取队列的长度               |
-| isEmpty() | 判断队列是否为空           |
+| isEmpty() | 判断队列是否为空             |
 
 </div>
 
@@ -143,13 +143,59 @@ comments: true
 === "JavaScript"
 
     ```js title="queue.js"
+    /* 初始化队列 */
+    // JavaScript 没有内置的队列，可以把 Array 当作队列来使用 
+    // 注意：由于是数组，所以 shift() 的时间复杂度是 O(n)
+    const queue = [];
 
+    /* 元素入队 */
+    queue.push(1);
+    queue.push(3);
+    queue.push(2);
+    queue.push(5);
+    queue.push(4);
+
+    /* 访问队首元素 */
+    const peek = queue[0];
+
+    /* 元素出队 */
+    // O(n)
+    const poll = queue.shift();
+
+    /* 获取队列的长度 */
+    const size = queue.length;
+
+    /* 判断队列是否为空 */
+    const empty = queue.length === 0;
     ```
 
 === "TypeScript"
 
     ```typescript title="queue.ts"
+    /* 初始化队列 */
+    // TypeScript 没有内置的队列，可以把 Array 当作队列来使用 
+    // 注意：由于是数组，所以 shift() 的时间复杂度是 O(n)
+    const queue: number[] = [];
 
+    /* 元素入队 */
+    queue.push(1);
+    queue.push(3);
+    queue.push(2);
+    queue.push(5);
+    queue.push(4);
+
+    /* 访问队首元素 */
+    const peek = queue[0];
+
+    /* 元素出队 */
+    // O(n)
+    const poll = queue.shift();
+
+    /* 获取队列的长度 */
+    const size = queue.length;
+
+    /* 判断队列是否为空 */
+    const empty = queue.length === 0;
     ```
 
 === "C"