当前位置：文江博客话题详情

IN/OUT 参数以及如何在 C++ 中使用它们

发布于 2024-11-27 11:01:42 字数 386 浏览 0 评论 0原文

当阅读有关来自不同类型的外部库的函数的文档时，我总是看到文档声明变量必须是[IN/OUT]。有人可以让我详细了解 [IN/OUT] 与通过引用或按值传递的函数参数之间的关系吗？

这是我遇到的一个函数示例，它告诉我它需要一个 [IN/OUT] 参数：

原型： ULONG GetActivationState( ULONG * pActivationState );

参数

类型： ULONG*
变量：pActivationState
模式：IN/OUT

原文

分享到QQ

分享到微博

如果你对这篇内容有疑问，欢迎到本站社区发帖提问参与讨论，获取更多帮助，或者扫码二维码加入 Web 技术交流群。

发布评论

需要登录才能够评论，你可以免费注册一个本站的账号。

一个人的旅程 2024-12-04 11:01:42

这部分适用于所有类型的参数 - 大多数库接口都尝试与 C 兼容，因此通过指针而不是通过引用传递参数更常见。

IN：当参数列为 IN 时，接口保证不会修改该参数。在我看来，通过将参数标记为 const 可以更好地传达这一点，然后语言本身将阻止对该值的修改。如果此参数按值传递，则无论在文档中将其标记为 IN（还是在原型中标记为 const）都无关紧要，因为该参数无论如何都是函数的本地参数。但为了避免复制，可以通过引用或指针传递它，在这种情况下 const 关键字就变得非常重要。

OUT： 标记为 OUT 的参数通常意味着该参数的值在传递给函数时并不重要。事实上，如果它是通过指针传递的，甚至可能要求它为NULL，并且该函数将分配内存并将一个值传递回给您。

IN/OUT： IN/OUT 参数通常表示输入和输出值都有意义的内容。例如，如果您有一个填充缓冲区的库函数，它可能需要您传递一个指向缓冲区的指针，以及另一个指示缓冲区长度的指针。当函数返回时，第二个指针可能包含已写入缓冲区的实际字节数。

回复收藏 0 原文

空名 2024-12-04 11:01:42

此参数是 in/out，因为您提供了一个在函数内部使用的值，并且函数会修改它以通知您函数内部发生的事情。该函数的用法如下：

ULONG activationState = 1; // example value
ULONG result = GetActivationState(&activationState);

请注意，您必须提供变量的地址，以便函数可以获取该值并在函数外部设置该值。例如，GetActivationState 函数可以执行如下操作：

ULONG GetActivationState(ULONG* pActivationState)
{
    if (*pActivationState == 1)
    {
    // do something
    // and inform by the modification of the variable, say, resetting it to 0
       *pActivationState = 0;
    }
    // ...
    return *pActivationState; // just an example, returns the same value
}

注意：

该函数接受参数作为指向 UINT 的非常量指针。这意味着它可能修改它。
该函数可以通过取消引用来访问您赋予参数的值。
该函数可以通过取消引用来再次修改该参数。
调用函数会看到 activationState 变量保存有new 值（本例中为 0）。

这是“按引用传递”的示例，它是通过使用 C 中的指针（以及 C++ 中的引用）来执行的。

This parameter is in/out because you provide a value that is used inside the function, and the function modifies it to inform you about something that happened inside the function. The usage of this function would be something like this:

ULONG activationState = 1; // example value
ULONG result = GetActivationState(&activationState);

note that you have to supply the address of the variable so that the function can get the value and set the value outside the function. For instance, the GetActivationState function can perform something like this:

ULONG GetActivationState(ULONG* pActivationState)
{
    if (*pActivationState == 1)
    {
    // do something
    // and inform by the modification of the variable, say, resetting it to 0
       *pActivationState = 0;
    }
    // ...
    return *pActivationState; // just an example, returns the same value
}

Note how:

The function accepts the parameter as a non-const pointer to an UINT. This means it may modify it.
The function can access the value you gave to the parameter by dereferencing it
The function can modify the parameter again by dereferencing it.
The calling function sees the activationState variable holding the new value (0 in this case).

This is an example of "pass by reference", which is performed by using pointers in C (and also with references in C++.)

回复收藏 0 原文