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++規格に対して遡及的に適用されました。

関連項目