在 C++14 中标记为不推荐使用的函数参数

Question

阅读 this blog post 及其 cmets，我注意到它作为示例提供了将特定函数参数标记为已弃用的可能性，如（示例取自帖子）：

// Deprecate a function parameter
int triple([[deprecated]] int x);

现在我想知道，这样的功能有什么好的用例？在那篇文章的 cmets 中或我搜索过的任何其他地方似乎都没有任何线索。

编辑：

要查看它的实际效果，有一个可编译的示例on goldbolt

Answer 1

假设你有这样一个函数：

void* allocate(std::size_t sz, void* hint = nullptr) {
    // if you give `hint` it *might* be more efficient
}

然后你决定不再值得努力做基于hint 的东西。所以你会这样做：

void* allocate(std::size_t sz, [[deprecated]] void* hint = nullptr) {
    // `hint` is ignored. The compiler warns me if I use it in the
    // function body accidentally, and people reading the function
    // signature can see that it is probably going to be ignored.
}

这允许库保持相同的签名/ABI（因此您不需要重新编译使用它的东西，遗留代码仍然可以继续使用它而不会造成任何伤害），并且还可以防止它被意外再次使用更改功能时。

但这主要是针对函数的开发人员，而不是函数的用户，将来他们知道为什么会有一个看似“无用”的参数。

我还认为这会禁用 gcc/clang 中带有 -Werror=unused-parameter 标志的“未使用参数”警告，但事实并非如此。使用(void) deprecated_parameter 也会发出关于使用已弃用参数的警告，因此这似乎是一个错误。如果它确实禁用了未使用的参数警告，那将是[[deprecated]] 的另一个用例。

Answer 2

规则是the attribute is valid on, amongst other things, variable declarations（广义上）。函数参数中的此类声明并未明确允许。

最初的提案N3394也没有提到这样的用例，原始功能in GCC（regardless accepts the equivalent usage）或in VS（我没有检查）的文档也没有提到铿锵声）。

因此，我认为这是允许的“意外”，而不是任何人真正想到的有用的东西。

像 Artyer 所探索的那样，记录已弃用的默认参数是否有用？是的，潜在的，模糊的。但正如 Artyer 还发现的那样，主流编译器实际上并没有以有用的方式对这种用法做出反应。

因此，目前，它没有有用，并且语言功能并不是专门为在这种情况下有用而设计的。

Answer 3

想象一个已实施、使用和维护多年的库。该库用于多个项目。
如果您只是删除该参数，则所有项目都必须在升级到新库版本后立即调整源代码才能再次编译。
如果将默认值添加到参数中，但不再使用该参数，则项目仍将编译而没有任何更改，但没有人会注意到某些内容已发生更改，并且可能由此参数控制的某些行为/功能确实不再工作了。

因此，通过将参数标记为已弃用，项目可以在不进行任何更改的情况下进行编译，但它们会收到警告，指出某些内容已更改并且应该更改其源代码，因为该参数迟早会消失。