c - 何时在 Doxygen 中将 [in] 与 [in,out] 与结构参数一起使用

Question

以下是 Doxygen 中 [in] 或 [in,out] 参数的示例吗？我有一个指向要传递给函数的结构的指针。该函数将修改结构的一部分，但不是全部。

此外，如果我返回相同的结构指针以使我能够进行函数链接怎么办？在这种情况下，我仍在修改一部分输入参数，但也返回它。

Answer 1

您的示例是[in,out]的情况。您获取struct(通过指针)，并且在函数返回后，struct 不再与以前相同。事实上，您不修改所有内容并且它保留在同一位置是无关紧要的。如果您的函数具有修改对象的副作用，那么它就是一个输出参数。

返回指向对象的指针这一事实不会影响您接受作为参数的对象被修改的事实。