add functional closure

Author: archibate

docs/functional.md

@@ -811,7 +811,7 @@ Lambda 函数对象的类型是匿名的，每个 Lambda 表达式都会创建
 
 唯一的代价是，你需要指定出所有参数的类型，和返回值的类型。
 
-例如一个参数为两个 `int`， `std::function<int(int, int)>`
+例如参数为两个 `int`，返回 `int` 的函数，可以用 `std::function<int(int, int)>` 容器存储。
 
 ```cpp
 auto add_lambda = [](int a, int b) { // Lambda 函数对象
@@ -865,10 +865,12 @@ int generic_sum(std::vector<int> const &v,
 
 ### 案例：函数对象的动态分发用于多线程任务队列
 
+主线程不断地向工作者线程发送函数对象，令其代为执行：
+
 ```cpp
 mt_queue<std::function<void()>> task_queue;
 
-void thread1() {
+void main_thread() {
     task_queue.push([] {
         fmt::println("正在执行任务1");
     });
@@ -877,7 +879,7 @@ void thread1() {
     });
 }
 
-void thread2() {
+void worker_thread() {
     while (true) {
         auto task = task_queue.pop();
         task();
@@ -889,6 +891,67 @@ void thread2() {
 
 ### 函数对象的重要机制：闭包
 
+闭包是函数对象的重要机制，他允许函数对象捕获外部变量，并在函数对象内部使用这些变量。
+
+```cpp
+int x = 10;
+auto add_x = [x](int a) {
+    return a + x;
+};
+fmt::println("{}", add_x(5)); // 输出 15
+```
+
+闭包捕获的变量默认是只读的，如果需要修改捕获的变量，需要使用 `mutable`。
+
+#### 闭包的本质是语法糖
+
+Lambda 函数对象的闭包语法：
+
+```cpp
+auto add_x = [x](int a) {
+    return a + x;
+};
+```
+
+实际上等价于一个带有 `operator()()` 的结构体：
+
+```cpp
+struct Lambda {
+    int x;
+    Lambda(int val) : x(val) {}
+
+    int operator()(int a) {
+        return a + x;
+    }
+};
+
+int main() {
+    Lambda add_x(10);
+    fmt::println("{}", add_x(5)); // 输出 15
+    return 0;
+}
+```
+
+而且这结构体是匿名的，没有确定的名字，此处类名 `Lambda` 只是示意。
+
+**而所谓的闭包捕获变量，实际上就是这个结构体的成员！**
+
+按值捕获，就相当于结构体成员里拷贝了一份同名的成员；如果是引用捕获，就相当于结构体里的成员是个引用。
+
+> {{ icon.tip }} 可以在 https://cppinsights.io 这个网站，自动拆解包括 Lambda 在内的所有现代 C++ 语法糖为原始的结构体和函数。更多好用的工具网站可以看我们 [工具和项目推荐](recommend.md) 专题章节。
+
+#### 闭包捕获变量的生命周期问题
+
+正因如此，闭包按值捕获（`[=]`）的变量，其生命周期和 Lambda 对象相同。
+
+当 Lambda 对象被拷贝时，其按值捕获的所有变量也会被重新拷贝一份。
+
+当 Lambda 对象被移动时，其按值捕获的所有变量也会随之一起移动。
+
+如果按值捕获了不能拷贝的对象（比如 `std::unique_ptr`），那么 Lambda 对象也会无法拷贝，只能移动。
+
+#### `operator()` 很有迷惑性
+
 ### 函数指针是 C 语言陋习，改掉
 
 ## bind 为函数对象绑定参数
@@ -921,3 +984,9 @@ int main() {
     return 0;
 }
 ```
+
+### `std::placeholders`
+
+### bind 是一个失败的设计
+
+### `std::bind_front` 和 `std::bind_back`

docs/img/thanks.png

@@ -4,7 +4,7 @@
 - learncpp.com
 - cppreference.com
 - godbolt.org
-- cpp-insights.io
+- cppinsights.io
 - quick-bench.com
 - github.com
 - stackoverflow.com

docs/recommend.md

@@ -27,6 +27,25 @@ class Order(namedtuple('Order', ['remark'])):
     User('**振', '', '20.00', ''),
     User('**伟', '', '20.00', ''),
     User('**枫', '', '26.90', ''),
+    User('相欢', '', '100.00', ''),
+    User('**辉', '', '30.00', '支持一下小彭老师，嘿嘿（求匿名）'),
+    User('**峰', '', '26.90', '感谢小鹏老师在技术上无私奉献，加油！'),
+    User('**卿', '', '26.60', ''),
+    User('**飞', '', '26.90', '黑心老板太可恶，资助老师吃饭�9�'),
+    User('**宇', '', '26.90', '给小彭老师点赞'),
+    User('**逸', '', '26.90', '绵薄之力，希望小彭老师早日度过难关'),
+    User('**帆', '', '10.00', '祝小彭老师生活顺利'),
+    User('**蓝', '', '500.00', '小彭老师加油�0�5�0�5'),
+    User('*洋', '', '26.90', ''),
+    User('**豪', '', '66.00', ''),
+    User('**楠', '', '26.90', '小彭老师加油！凭你的才华没问题的'),
+    User('*锷', '', '100.00', ''),
+    User('**博', '', '30.00', '小彭老师加油，你这么优秀肯定能找到好工作'),
+    User('**运', '', '30.00', '小彭老师加油！B站视频太棒啦！'),
+    User('windy小助手', 'https://i0.hdslb.com/bfs/face/d5d323e4063cad911bd722292fbf67dc6a23493b.jpg', '500.00', ''),
+    User('**康', '', '40.00', '感谢小彭老师的指导'),
+    User('*坤', '', '40.00', ''),
+    User('**峰', '', '20.00', ''),
 ]
 
 def afd_query(which, **params):
@@ -35,7 +54,7 @@ def afd_query(which, **params):
     ts = int(time.time())
     params = json.dumps(params)
     sign = hashlib.md5(f'{token}params{params}ts{ts}user_id{user_id}'.encode('utf-8')).hexdigest()
-    res = requests.get(f'https://afdian.net/api/open/{which}', params={
+    res = requests.get(f'https://afdian.com/api/open/{which}', params={
         'user_id': user_id,
         'params': params,
         'ts': ts,
@@ -86,7 +105,7 @@ def afd_gen_thank_list():
     max_y = 30
     stride_x = 450
     stride_y = 120
-    limit_y = 720
+    limit_y = stride_y * 10
     max_max_y = max_y
     for user in sponsors:
         max_y += stride_y
@@ -104,7 +123,8 @@ def afd_gen_thank_list():
     for user in sponsors:
         draw = ImageDraw.Draw(img)
         font = ImageFont.truetype('/usr/share/fonts/noto-cjk/NotoSansCJK-Medium.ttc', size=20)
-        font_small = ImageFont.truetype('/usr/share/fonts/noto-cjk/NotoSerifCJK-Medium.ttc', size=13)
+        font_small = ImageFont.truetype('/usr/share/fonts/noto-cjk/NotoSansCJK-Medium.ttc', size=13)
+        # font_small = ImageFont.truetype('/usr/share/fonts/Unifont/Unifont.otf', size=13)
         if user.avatar:
             avatar = Image.open(BytesIO(requests.get(user.avatar).content))
         else:
@@ -121,6 +141,11 @@ def afd_gen_thank_list():
         remark = user.remark
         if remark:
             remark = remark.rstrip('。').replace('.。', '，')
+            # chunk remark into 40 char per line:
+            chunk_size = int((stride_x - 100) / font_small.size)
+            if len(remark) > chunk_size:
+                remark_lines = [remark[i:i+chunk_size] for i in range(0, len(remark), chunk_size)]
+                remark = '\n'.join(remark_lines)
             draw.text((x + 100, y + 60), f'{remark}', fill='#779977', font=font_small)
         print(f'{user.name} ￥{user.all_sum_amount} {remark}')
         total += float(user.all_sum_amount)