Merge branch 'master' of https://github.com/PegasusWang/python_data_structures_and_algorithms

Author: PegasusWang

.github/FUNDING.yml

@@ -0,0 +1,4 @@
+# These are supported funding model platforms
+
+github: [PegasusWang]
+custom: ["https://www.paypal.me/pegasuswang"]

163_course.png

@@ -27,7 +27,7 @@
 - 网上很多视频教程不够循序渐进，不成系统
 
 ## 作者简介
-曾就职于[知乎](https://www.zhihu.com/people/pegasus-wang/activities)，任后端工程师，多年 Python 开发经验。
+曾就职于[知乎](https://www.zhihu.com/people/pegasus-wang/activities)，现腾讯后端工程师，多年 Python 开发经验。
 
 知乎专栏：
 
@@ -301,9 +301,9 @@ def test():
 如果读者关于代码、视频、讲义有任何疑问，欢迎一起讨论
 请注意以下几点：
 
-- 优先在网易云课堂的讨论区提问，方便别的同学浏览。如果未购买视频，也可以直接在 github 里提出 issue，笔者有空会给大家解答和讨论。
-- 描述尽量具体，视频或者代码哪一部分有问题？请尽量把涉及章节和代码贴出来，方便定位问题。
+- 描述尽量具体，视频或者代码哪一部分有问题(可以具体到文档或者代码行数)？请尽量把涉及章节和代码贴出来，方便定位问题。
 - 如果涉及到代码，提问时请保持代码的格式
+- 如果直接提了代码bug，最好有相关测试用例展示失败 test case，方便复现问题
 
 
 ## 本电子书制作和写作方式
@@ -331,4 +331,4 @@ mkdocs gh-deploy    # 部署到自己的 github pages
 
 扫码加入课程：
 
-![扫码加入课程返现30%](https://camo.githubusercontent.com/a217604a83d60fdc610ba91e5c771664a4645a79/687474703a2f2f376b747574792e636f6d312e7a302e676c622e636c6f7564646e2e636f6d2f53637265656e25323053686f74253230323031382d30362d3032253230617425323032302e33372e34362e706e67)
+![扫码加入课程](./163_course.png)

README.md

@@ -77,7 +77,10 @@ def remove(self, value):    # O(n)
             if curnode.value == value:
                 prevnode.next = curnode.next
                 if curnode is self.tailnode:  # NOTE: 注意更新 tailnode
-                    self.tailnode = prevnode
+                    if prevnode is self.root:
+                        self.tailnode = None
+                    else:
+                        self.tailnode = prevnode
                 del curnode
                 self.length -= 1
                 return 1  # 表明删除成功
@@ -185,6 +188,13 @@ def test_linked_list_remove():
     ll.remove(7)
     print(list(ll))
 
+def test_single_node():
+    # https://github.com/PegasusWang/python_data_structures_and_algorithms/pull/21
+    ll = LinkedList()
+    ll.append(0)
+    ll.remove(0)
+    ll.appendleft(1)
+    assert list(ll) == [1]
 
 def test_linked_list_reverse():
     ll = LinkedList()
@@ -203,6 +213,7 @@ def test_linked_list_append():
 
 
 if __name__ == '__main__':
+    test_single_node()
     test_linked_list()
     test_linked_list_append()
     test_linked_list_reverse()

docs/03_链表/linked_list.py

@@ -28,8 +28,10 @@ def __iter__(self):
 
 
 class Slot(object):
-    """定义一个 hash 表 数组的槽
-    注意，一个槽有三种状态，看你能否想明白。相比链接法解决冲突，二次探查法删除一个 key 的操作稍微复杂。
+    """定义一个 hash 表数组的槽(slot 这里指的就是数组的一个位置)
+    hash table 就是一个 数组，每个数组的元素（也叫slot槽）是一个对象，对象包含两个属性 key 和 value。
+
+    注意，一个槽有三种状态，看你能否想明白。相比链接法解决冲突，探查法删除一个 key 的操作稍微复杂。
     1.从未使用 HashMap.UNUSED。此槽没有被使用和冲突过，查找时只要找到 UNUSED 就不用再继续探查了
     2.使用过但是 remove 了，此时是 HashMap.EMPTY，该探查点后边的元素仍然可能是有key的，需要继续查找
     3.槽正在使用 Slot 节点
@@ -60,23 +62,33 @@ def _hash(self, key):
         return abs(hash(key)) % len(self._table)
 
     def _find_key(self, key):
-        index = self._hash(key)
+        """
+        解释一个 slot 为 UNUSED 和 EMPTY 的区别
+        因为使用的是二次探查的方式，假如有两个元素 A，B 冲突了，首先A hash 得到是 slot 下标5，A 放到了第5个槽，之后插入 B 因为冲突了，所以继续根据二次探查方式放到了 slot8。
+        然后删除 A，槽 5 被置为 EMPTY。然后我去查找 B，第一次 hash 得到的是 槽5，但是这个时候我还是需要第二次计算 hash 才能找到 B。但是如果槽是 UNUSED 我就不用继续找了，我认为 B 就是不存在的元素。这个就是 UNUSED 和 EMPTY 的区别。
+        """
+        origin_index = index = self._hash(key) # origin_index 判断是否又走到了起点，如果查找一圈了都找不到则无此元素
         _len = len(self._table)
         while self._table[index] is not HashTable.UNUSED:
-            if self._table[index] is HashTable.EMPTY:
-                index = (index*5 + 1) % _len
+            if self._table[index] is HashTable.EMPTY:  # 注意如果是 EMPTY，继续寻找下一个槽
+                index = (index * 5 + 1) % _len
+                if index == origin_index:
+                    break
                 continue
-            elif self._table[index].key == key:
+            if self._table[index].key == key:  # 找到了key
                 return index
             else:
-                index = (index*5 + 1) % _len
+                index = (index * 5 + 1) % _len  # 没有找到继续找下一个位置
+                if index == origin_index:
+                    break
+
         return None
 
     def _find_slot_for_insert(self, key):
         index = self._hash(key)
         _len = len(self._table)
-        while not self._slot_can_insert(index):
-            index = (index*5 + 1) % _len
+        while not self._slot_can_insert(index):  # 直到找到一个可以用的槽
+            index = (index * 5 + 1) % _len
         return index
 
     def _slot_can_insert(self, index):