std::ignore

const /*ignore-type*/ ignore;

constexpr /*ignore-type*/ ignore;

struct /*ignore-type*/
{
    template< class T >
    const /*ignore-type*/& operator=( const T& ) const noexcept
    {
        return *this;
    }
};

struct /*ignore-type*/
{
    template< class T >
    constexpr const /*ignore-type*/& operator=( const T& ) const noexcept
    {
        return *this;
    }
};

注释

无法将 void 表达式或 volatile 位域值赋值给 std::ignore 。

std::ignore 旨在与 std::tie 配合使用，在解包 std::tuple 时作为未使用参数的占位符，但也可用于任何不需要的赋值场景。

一些代码规范建议使用 std::ignore 来避免未使用的 [[ nodiscard ]] 函数返回值引发的警告，即使并不需要进行赋值操作。

对于需要忽略但无需赋值的值，可以将其强制转换为 void 。对于已命名但未使用其值的变量，可以将其强制转换为 void ，或使用 [[ maybe_unused ]] 属性声明这些变量。

示例

1. 演示了将 std::ignore 与 [[ nodiscard ]] 函数结合使用的场景。
2. 解包由 std:: pair < iterator, bool > 返回的 std:: set :: insert ( ) 返回值，但仅保存布尔值部分。

#include <iostream>
#include <set>
#include <string>
#include <tuple>
[[nodiscard]] int dontIgnoreMe()
{
    return 42;
}
int main()
{
    std::ignore = dontIgnoreMe();
    std::set<std::string> set_of_str;
    if (bool inserted{false};
        std::tie(std::ignore, inserted) = set_of_str.insert("Test"),
        inserted)
        std::cout << "Value was inserted successfully.\n";
}

Value was inserted successfully.

缺陷报告

下列行为变更缺陷报告被追溯应用于先前发布的 C++ 标准。

参见