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++.

См. также