docs(python-core): add convert-bytes-to-any-ctypes

Author: Sun-ZhenXing

docs/pypi-package/pyside6/chapter04/index.md

@@ -6,3 +6,57 @@ description: 第 4 章：PySide6 控件
 # 4. PySide6 控件
 
 [[TOC]]
+
+## QButtonGroup
+
+在 Qt Designer 中，选择多个 `RadioButton` 对象右键，选择分配给按钮组，新建按钮组即可创建一个 `QButtonGroup`。
+
+## 使用 InputMask 设置字符掩码
+
+`QLineEdit` 有一个属性是 `InputMask`，可以使用 `setInputMask` 进行设置，目的是设置字符掩码，限制用户输入的内容必须符合掩码。[^1]
+
+[^1]: QLineEdit，Qt6，<https://doc.qt.io/qt-6/qlineedit.html#inputMask-prop>
+
+下面是 Qt6 规范：
+
+| 掩码字符 | 含义                                |
+| :------: | :---------------------------------- |
+|   `A`    | 只能是字母且必须，取值为 `[a-zA-Z]` |
+|   `a`    | 同上但不是必须的                    |
+|   `N`    | 字母或数字 `[0-9a-zA-Z]`            |
+|   `n`    | 同上但不是必须的                    |
+|   `X`    | 任何字符                            |
+|   `x`    | 同上但不是必须的                    |
+|   `9`    | 数字 `[0-9]`                        |
+|   `0`    | 同上但不是必须的                    |
+|   `D`    | 数字 `[1-9]`                        |
+|   `d`    | 同上但不是必须的                    |
+|   `#`    | 数字或加减号 `[0-9+-]`，不是必须的  |
+|   `H`    | 十六进制字符 `[0-9a-fA-F]`          |
+|   `h`    | 同上但不是必须的                    |
+|   `B`    | 二进制字符 `[01]`                   |
+|   `b`    | 同上但不是必须的                    |
+
+还可以使用元字符用于增强规则：
+
+|  元字符   | 含义                               |
+| :-------: | :--------------------------------- |
+|    `>`    | 所有字符都被转换为大写             |
+|    `<`    | 所有字符都被转换为小写             |
+|    `!`    | 关闭大小写转换                     |
+|   `;c`    | 终止掩码规则并将空字符设置为 *`c`* |
+| `[ ] { }` | 保留内容                           |
+|    `\`    | 转义上述掩码字符或元字符           |
+
+总结：
+- 掩码字符中，大写为必须输入，小写为可选
+- 元字符可以混合使用以便控制输入方式
+
+| 实例                               | 含义                         |
+| ---------------------------------- | ---------------------------- |
+| `000.000.000.000;_`                | IP 地址，`_` 表示空白        |
+| `HH:HH:HH:HH:HH:HH;_`              | MAC 地址                     |
+| `0000-00-00`                       | ISO 日期，空白为空格 `' '`   |
+| `>AAAAA-AAAAA-AAAAA-AAAAA-AAAAA;#` | 许可证号码，大写，空白为 `#` |
+
+如果我需要设计一个输入 4 字节十六进制数字的输入框，可以使用 `>HH-HH-HH-HH;_` 来表示。

docs/python-core/collections/convert-bytes-to-any-ctypes.md

@@ -0,0 +1,44 @@
+---
+title: 将 bytes 转换为任意 C 类型
+description: 将 bytes 转换为任意 C 类型
+---
+
+# 将 bytes 转换为任意 C 类型
+
+下面的方法实现了 `bytes` 转换到任意 C 类型。
+
+```python
+from ctypes import POINTER, c_char_p, c_double, cast, sizeof
+from typing import TypeVar
+
+_T = TypeVar('_T')
+
+def cast_bytes(data_bytes: bytes, ctype: type[_T]) -> _T:
+    """Cast bytes to a ctype"""
+    assert len(data_bytes) >= sizeof(ctype)
+    return cast(
+        c_char_p(data_bytes),
+        POINTER(ctype)
+    ).contents
+
+v = cast_bytes(b'\x7f' * 8, c_double)
+print(v.value)
+```
+
+这样我们就获得了一个 `c_double` 类型的 `v` 变量，使用 `v.value` 很容易获得其值。
+
+以上的代码相当于下面的 C++ 代码：
+
+```cpp
+#include <iostream>
+using namespace std;
+
+int main() {
+    char a[] = "\x7f\x7f\x7f\x7f\x7f\x7f\x7f\x7f";
+    double value = *(double*)a;
+    cout << value << endl;
+    return 0;
+}
+```
+
+如果需要使用 Python 将 C 类型转换为二进制表示，使用 `memoryview` 即可。

package.json

@@ -20,12 +20,12 @@
   "author": "Alex",
   "license": "ISC",
   "devDependencies": {
-    "@vuepress/client": "2.0.0-beta.60",
+    "@vuepress/client": "2.0.0-beta.61",
     "vue": "^3.2.47",
-    "vuepress": "2.0.0-beta.60",
-    "vuepress-plugin-auto-catalog": "2.0.0-beta.181",
-    "vuepress-plugin-copy-code2": "2.0.0-beta.181",
-    "vuepress-plugin-md-enhance": "2.0.0-beta.181",
-    "vuepress-plugin-search-pro": "2.0.0-beta.181"
+    "vuepress": "2.0.0-beta.61",
+    "vuepress-plugin-auto-catalog": "2.0.0-beta.185",
+    "vuepress-plugin-copy-code2": "2.0.0-beta.185",
+    "vuepress-plugin-md-enhance": "2.0.0-beta.185",
+    "vuepress-plugin-search-pro": "2.0.0-beta.185"
   }
 }