merge

Author: archibate

docs/design_gamedev.md

@@ -77,9 +77,12 @@ private:
     Game() { ... }
 
 public:
-    inline static Game instance;  // 如果定义在头文件中，需要 inline！
+    // inline static Game instance;  // 虽然很爽，但不能这样写，因为 Game 在他的 }; 结束前都是不完整类型
+    static Game instance;  // 非定义声明，就好比全局变量的 extern Game instance 一样，不需要是完整类型
 };
 
+inline Game Game::instance;  // 如果定义在头文件中，需要 inline！
+
 Game::instance.updatePlayers();
 ```
 

docs/design_virtual.md

@@ -178,9 +178,9 @@ struct Reducer {
 };
 
 int reduce(vector<int> v, Reducer *reducer) {
-    int res = reducer.init();
+    int res = reducer->init();
     for (int i = 0; i < v.size(); i++) {
-        res = reducer.add(res, v[i]);
+        res = reducer->add(res, v[i]);
     }
     return res;
 }
@@ -251,12 +251,12 @@ SumReducer 和 ProductReducer 无需任何修改，体现了**开闭原则**。
 
 ```cpp
 int reduce(Reducer *reducer) {
-    int res = reducer.init();
+    int res = reducer->init();
     while (true) {
         int tmp;
         cin >> tmp;
         if (tmp == -1) break;
-        res = reducer.add(res, tmp);
+        res = reducer->add(res, tmp);
     }
     return res;
 }
@@ -268,20 +268,20 @@ int reduce(Reducer *reducer) {
 
 ```cpp
 int cin_reduce(Reducer *reducer) {
-    int res = reducer.init();
+    int res = reducer->init();
     while (true) {
         int tmp;
         cin >> tmp;
         if (tmp == -1) break;
-        res = reducer.add(res, tmp);
+        res = reducer->add(res, tmp);
     }
     return res;
 }
 
 int vector_reduce(vector<int> v, Reducer *reducer) {
-    int res = reducer.init();
+    int res = reducer->init();
     for (int i = 0; i < v.size(); i++) {
-        res = reducer.add(res, v[i]);
+        res = reducer->add(res, v[i]);
     }
     return res;
 }
@@ -297,9 +297,9 @@ struct Inputer {
 };
 
 int reduce(Inputer *inputer, Reducer *reducer) {
-    int res = reducer.init();
-    while (int tmp = inputer.fetch()) {
-        res = reducer.add(res, tmp);
+    int res = reducer->init();
+    while (int tmp = inputer->fetch()) {
+        res = reducer->add(res, tmp);
     }
     return res;
 }
@@ -353,9 +353,9 @@ Inputer 负责告诉 reduce 函数如何读取数据，Reducer 负责告诉 redu
 
 ```cpp
 int reduce(Reducer *reducer) {
-    int res = reducer.init();
-    while (int tmp = reducer.fetch()) {  // fetch 凭什么和 init、add 放在一起？
-        res = reducer.add(res, tmp);
+    int res = reducer->init();
+    while (int tmp = reducer->fetch()) {  // fetch 凭什么和 init、add 放在一起？
+        res = reducer->add(res, tmp);
     }
     return res;
 }
@@ -430,7 +430,7 @@ struct StopInputerAdapter : Inputer {
     {}
 
     optional<int> fetch() override {
-        auto tmp = inputer.fetch();
+        auto tmp = inputer->fetch();
         if (tmp == stopMark)
             return nullopt;
         return tmp;
@@ -466,7 +466,7 @@ struct FilterInputerAdapter {
 
     optional<int> fetch() override {
         while (true) {
-            auto tmp = inputer.fetch();
+            auto tmp = inputer->fetch();
             if (!tmp.has_value()) {
                 return nullopt;
             }
@@ -515,7 +515,7 @@ struct FilterInputerAdapter : Inputer {
 
     optional<int> fetch() override {
         while (true) {
-            auto tmp = inputer.fetch();
+            auto tmp = inputer->fetch();
             if (!tmp.has_value()) {
                 return nullopt;
             }
@@ -588,8 +588,8 @@ struct PoostInputerAdapter {
     {}
 
     optional<int> fetch() override {
-        if (poostIn.hasNext()) {
-            return poostIn.getNext();
+        if (poostIn->hasNext()) {
+            return poostIn->getNext();
         } else {
             return nullopt;
         }

docs/hello_world.md

@@ -60,6 +60,8 @@ main 函数总是返回一个整数 (`int` 类型)，用这个整数向操作系
 
 如果程序正常执行完毕，正常结束退出，那就请返回 0。
 
+> {{ icon.detail }} 通常来说有返回类型的函数都需要在所有分支都有 return 语句，但有趣的是，C++ 标准对 main 函数做了特殊的“宽大处理”：在控制流达到 main 函数的结尾时，如果没有遇到 `return` 语句，则等价于执行 `return 0;`。所以对于你本来就打算返回 0 的情况，也可以偷懒不写 `return` 语句，编译器自动会帮你加上。以及，main 函数必须返回 `int` 类型，不能返回 `void` 类型。
+
 返回一个不为 0 的整数可以表示程序出现了异常，是因为出错了才退出的，值的多少可以用于表明错误的具体原因。
 
 > {{ icon.fun }} 操作系统：我调用了你这个程序的 main 函数，我好奇程序是否正确执行了？让我们约定好：如果你运转正常的话，就返回0表示成功哦！如果有错误的话，就返回一个错误代码，比如返回1表示无权限，2表示找不到文件……之类的。当然，错误代码都是不为0的。

docs/img/clang-ast-example.png

@@ -30,7 +30,7 @@
 
 也可以在 [B 站](https://space.bilibili.com/263032155) 发私信给小彭老师哦。
 
-> {{ icon.tip }} 本书还在持续更新中……要追番的话，可以在 [GitHub]({{ config.repo_url }}) 点一下右上角的 “Watch” 按钮，每当小彭老师提交新 commit，GitHub 会向你发送一峰电子邮件，提醒你小彭老师更新了。
+> {{ icon.tip }} 本书还在持续更新中……要追番的话，可以在 [GitHub]({{ config.repo_url }}) 点一下右上角的 “Watch” 按钮，每当小彭老师提交新 commit，GitHub 会向你发送一封电子邮件，提醒你小彭老师更新了。
 
 更新时间：{{ build_date }}
 
@@ -98,12 +98,12 @@ void try_call_foo(T &t) {
 ```cpp
 template <class T, class = void>
 struct has_foo {
-    inline constexpr bool value = false;
+    static constexpr bool value = false;
 };
 
 template <class T>
 struct has_foo<T, std::void_t<decltype(std::declval<T>().foo())>> {
-    inline constexpr bool value = true;
+    static constexpr bool value = true;
 };
 
 template <class T>
@@ -160,7 +160,7 @@ void try_call_foo(T &) {
 }
 ```
 
-如果回到 C++98，那又要罪加一等！`enable_if` 和 是 C++11 引入的 `<type_traits>` 头文件的帮手类，在 C++98 中，我们需要自己实现 `enable_if`…… `declval` 也是 C++11 引入的 `<utility>` 头文件中的帮手函数……假设你自己好不容易实现出来了 `enable_if` 和 `declval`，还没完：因为 constexpr 在 C++98 中也不存在了！你无法定义 value 成员变量为编译期常量，我们只好又用一个抽象的枚举小技巧来实现定义类成员常量的效果。
+如果回到 C++98，那又要罪加一等！`enable_if` 和 `declval` 是 C++11 引入的 `<type_traits>` 头文件的帮手类和帮手函数，在 C++98 中，我们需要自己实现 `enable_if`…… `declval` 也是 C++11 引入的 `<utility>` 头文件中的帮手函数……假设你自己好不容易实现出来了 `enable_if` 和 `declval`，还没完：因为 constexpr 在 C++98 中也不存在了！你无法定义 value 成员变量为编译期常量，我们只好又用一个抽象的枚举小技巧来实现定义类成员常量的效果。
 
 ```cpp
 template <class T, class = void>