c++ - C/C++函数/方法修饰

Question

免责声明:我已经有一段时间没有使用 C++ 了...

现在装饰 C/C++ 函数/方法声明以提高可读性是否很常见？

粗略示例:

void some_function(IN int param1, OUT char **param2);

宏 IN 和 OUT 定义了一个空 主体(如果您愿意的话，在这个例子中就是轻量级文档)。当然，我理解这与与方法/函数关联的“文档注释 block ”在某种程度上是平行的。

您能否提供一些其他示例...假设该主题对社区有用。 请记住上面的例子就是这样。

Answer 1

我不会欣赏这样的装饰。

使用 const 和引用以及常量引用要好得多，例如

void some_function(AClass const &param1, AnotherClass &param2)

通常 int 是按值传递而不是按引用传递，所以我使用 AClass 和 AnotherClass 作为示例。在我看来，添加 empy IN 和 OUT 会让人分心。