refactor: Replace 'poll' with 'pop' in Heap (#416)

This commit is contained in:
Yudong Jin
2023-03-13 22:31:05 +08:00
committed by GitHub
parent 8aebbaad21
commit 28aacccf44
27 changed files with 91 additions and 152 deletions

View File

Before

Width:  |  Height:  |  Size: 68 KiB

After

Width:  |  Height:  |  Size: 68 KiB

View File

Before

Width:  |  Height:  |  Size: 89 KiB

After

Width:  |  Height:  |  Size: 89 KiB

View File

Before

Width:  |  Height:  |  Size: 66 KiB

After

Width:  |  Height:  |  Size: 66 KiB

View File

Before

Width:  |  Height:  |  Size: 69 KiB

After

Width:  |  Height:  |  Size: 69 KiB

View File

Before

Width:  |  Height:  |  Size: 81 KiB

After

Width:  |  Height:  |  Size: 81 KiB

View File

Before

Width:  |  Height:  |  Size: 89 KiB

After

Width:  |  Height:  |  Size: 89 KiB

View File

Before

Width:  |  Height:  |  Size: 84 KiB

After

Width:  |  Height:  |  Size: 84 KiB

View File

Before

Width:  |  Height:  |  Size: 93 KiB

After

Width:  |  Height:  |  Size: 93 KiB

View File

Before

Width:  |  Height:  |  Size: 86 KiB

After

Width:  |  Height:  |  Size: 86 KiB

View File

Before

Width:  |  Height:  |  Size: 95 KiB

After

Width:  |  Height:  |  Size: 95 KiB

View File

@@ -19,17 +19,17 @@
而恰好,**堆的定义与优先队列的操作逻辑完全吻合**,大顶堆就是一个元素从大到小出队的优先队列。从使用角度看,我们可以将「优先队列」和「堆」理解为等价的数据结构。因此,本文与代码对两者不做特别区分,统一使用「堆」来命名。
堆的常用操作见下表方法命名以 Java 为例)
堆的常用操作见下表方法名需根据编程语言确定
<div class="center-table" markdown>
| 方法 | 描述 | 时间复杂度 |
| --------- | -------------------------------------------- | ----------- |
| add() | 元素入堆 | $O(\log n)$ |
| poll() | 堆顶元素出堆 | $O(\log n)$ |
| peek() | 访问堆顶元素(大 / 小顶堆分别为最大 / 小值) | $O(1)$ |
| size() | 获取堆的元素数量 | $O(1)$ |
| isEmpty() | 判断堆是否为空 | $O(1)$ |
| 方法 | 描述 | 时间复杂度 |
| --------- | ------------------------------------------ | ----------- |
| push() | 元素入堆 | $O(\log n)$ |
| pop() | 堆顶元素出堆 | $O(\log n)$ |
| peek() | 访问堆顶元素(大 / 小顶堆分别为最大 / 小值) | $O(1)$ |
| size() | 获取堆的元素数量 | $O(1)$ |
| isEmpty() | 判断堆是否为空 | $O(1)$ |
</div>
@@ -49,11 +49,11 @@
Queue<Integer> maxHeap = new PriorityQueue<>((a, b) -> b - a);
/* 元素入堆 */
maxHeap.add(1);
maxHeap.add(3);
maxHeap.add(2);
maxHeap.add(5);
maxHeap.add(4);
maxHeap.offer(1);
maxHeap.offer(3);
maxHeap.offer(2);
maxHeap.offer(5);
maxHeap.offer(4);
/* 获取堆顶元素 */
int peek = maxHeap.peek(); // 5
@@ -217,11 +217,11 @@
/* 堆顶元素出堆 */
// 调用 heap.Interface 的方法,来移除元素
heap.Pop(maxHeap)
heap.Pop(maxHeap)
heap.Pop(maxHeap)
heap.Pop(maxHeap)
heap.Pop(maxHeap)
heap.Pop(maxHeap) // 5
heap.Pop(maxHeap) // 4
heap.Pop(maxHeap) // 3
heap.Pop(maxHeap) // 2
heap.Pop(maxHeap) // 1
/* 获取堆大小 */
size := len(*maxHeap)
@@ -236,13 +236,13 @@
=== "JavaScript"
```javascript title="heap.js"
// JavaScript 未提供内置 heap 类
// JavaScript 未提供内置 Heap 类
```
=== "TypeScript"
```typescript title="heap.ts"
// TypeScript 未提供内置 Heap 类
// TypeScript 未提供内置 Heap 类
```
=== "C"
@@ -291,7 +291,7 @@
=== "Swift"
```swift title="heap.swift"
// Swift 未提供内置 heap 类
// Swift 未提供内置 Heap 类
```
=== "Zig"
@@ -597,41 +597,41 @@
顾名思义,**从顶至底堆化的操作方向与从底至顶堆化相反**,我们比较根结点的值与其两个子结点的值,将最大的子结点与根结点执行交换,并循环以上操作,直到越过叶结点时结束,或当遇到无需交换的结点时提前结束。
=== "<1>"
![堆顶元素出堆步骤](heap.assets/heap_poll_step1.png)
![堆顶元素出堆步骤](heap.assets/heap_pop_step1.png)
=== "<2>"
![heap_poll_step2](heap.assets/heap_poll_step2.png)
![heap_pop_step2](heap.assets/heap_pop_step2.png)
=== "<3>"
![heap_poll_step3](heap.assets/heap_poll_step3.png)
![heap_pop_step3](heap.assets/heap_pop_step3.png)
=== "<4>"
![heap_poll_step4](heap.assets/heap_poll_step4.png)
![heap_pop_step4](heap.assets/heap_pop_step4.png)
=== "<5>"
![heap_poll_step5](heap.assets/heap_poll_step5.png)
![heap_pop_step5](heap.assets/heap_pop_step5.png)
=== "<6>"
![heap_poll_step6](heap.assets/heap_poll_step6.png)
![heap_pop_step6](heap.assets/heap_pop_step6.png)
=== "<7>"
![heap_poll_step7](heap.assets/heap_poll_step7.png)
![heap_pop_step7](heap.assets/heap_pop_step7.png)
=== "<8>"
![heap_poll_step8](heap.assets/heap_poll_step8.png)
![heap_pop_step8](heap.assets/heap_pop_step8.png)
=== "<9>"
![heap_poll_step9](heap.assets/heap_poll_step9.png)
![heap_pop_step9](heap.assets/heap_pop_step9.png)
=== "<10>"
![heap_poll_step10](heap.assets/heap_poll_step10.png)
![heap_pop_step10](heap.assets/heap_pop_step10.png)
与元素入堆操作类似,**堆顶元素出堆操作的时间复杂度为 $O(\log n)$** 。
=== "Java"
```java title="my_heap.java"
[class]{MaxHeap}-[func]{poll}
[class]{MaxHeap}-[func]{pop}
[class]{MaxHeap}-[func]{siftDown}
```
@@ -639,7 +639,7 @@
=== "C++"
```cpp title="my_heap.cpp"
[class]{MaxHeap}-[func]{poll}
[class]{MaxHeap}-[func]{pop}
[class]{MaxHeap}-[func]{siftDown}
```
@@ -647,7 +647,7 @@
=== "Python"
```python title="my_heap.py"
[class]{MaxHeap}-[func]{poll}
[class]{MaxHeap}-[func]{pop}
[class]{MaxHeap}-[func]{sift_down}
```
@@ -655,7 +655,7 @@
=== "Go"
```go title="my_heap.go"
[class]{maxHeap}-[func]{poll}
[class]{maxHeap}-[func]{pop}
[class]{maxHeap}-[func]{siftDown}
```
@@ -663,7 +663,7 @@
=== "JavaScript"
```javascript title="my_heap.js"
[class]{MaxHeap}-[func]{poll}
[class]{MaxHeap}-[func]{pop}
[class]{MaxHeap}-[func]{#siftDown}
```
@@ -671,7 +671,7 @@
=== "TypeScript"
```typescript title="my_heap.ts"
[class]{MaxHeap}-[func]{poll}
[class]{MaxHeap}-[func]{pop}
[class]{MaxHeap}-[func]{siftDown}
```
@@ -679,7 +679,7 @@
=== "C"
```c title="my_heap.c"
[class]{maxHeap}-[func]{poll}
[class]{maxHeap}-[func]{pop}
[class]{maxHeap}-[func]{siftDown}
```
@@ -687,7 +687,7 @@
=== "C#"
```csharp title="my_heap.cs"
[class]{MaxHeap}-[func]{poll}
[class]{MaxHeap}-[func]{pop}
[class]{MaxHeap}-[func]{siftDown}
```
@@ -695,7 +695,7 @@
=== "Swift"
```swift title="my_heap.swift"
[class]{MaxHeap}-[func]{poll}
[class]{MaxHeap}-[func]{pop}
[class]{MaxHeap}-[func]{siftDown}
```
@@ -703,7 +703,7 @@
=== "Zig"
```zig title="my_heap.zig"
[class]{MaxHeap}-[func]{poll}
[class]{MaxHeap}-[func]{pop}
[class]{MaxHeap}-[func]{siftDown}
```