对于某些固定参数使用枚举

发布于 2025-04-06 22:09:47 浏览：152 订阅该版

聚散无由 2025-04-07

https://jswyll.com

```c
#define RT_DEVICE_OFLAG_RDONLY          0x001           /**< read only access */
#define RT_DEVICE_OFLAG_WRONLY          0x002           /**< write only access */
#define RT_DEVICE_OFLAG_RDWR            0x003           /**< read and write */
#define RT_DEVICE_FLAG_REMOVABLE        0x004           /**< removable device */
#define RT_DEVICE_FLAG_STANDALONE       0x008           /**< standalone device */
#define RT_DEVICE_FLAG_INT_RX           0x100           /**< INT mode on Rx */
#define RT_DEVICE_FLAG_DMA_RX           0x200           /**< DMA mode on Rx */
#define RT_DEVICE_FLAG_INT_TX           0x400           /**< INT mode on Tx */
#define RT_DEVICE_FLAG_DMA_TX           0x800           /**< DMA mode on Tx */
```

可以用或运算多个标志位，表示同时选择多个功能，例如已经定义的RT_DEVICE_OFLAG_RDWR其实就是`RT_DEVICE_OFLAG_RDONLY | RT_DEVICE_OFLAG_WRONLY`。

用枚举岂不是很麻烦？

---

不过，非枚举或结构体不可直接跳转的这种最好是在doxygen注释中定义一个组，在函数中使用`@ref`或相关指令引用到宏定义或网页，那样就能在[doxygen](https://www.rt-thread.org/document/api/group___device.html#gac0cd9f7a81722d69e8720ea4750c17a2)或支持的工具中跳转过去，免得每次去找文档。

其它编程语言的样子：

```
/**
 * 处理点击webview面板的生成按钮，开始生成项目配置文件。
 *
 * ...
 *
 * @param params 生成参数{@link GenerateParamsInternal}
 */
async function startGenerate(params: GenerateParamsInternal) {
}
```

在调用的时候如果不清楚，鼠标悬浮这个函数，可以快速跳转：

![screenshot_76.png](https://oss-club.rt-thread.org/uploads/20250407/1f71306c7132811d009aa5094c8436c5.png.webp)