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

Question

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

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

Answer 1

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

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