[[nodiscard]]属性

编译器支持最低版本要求:

GCC: 7

MSVC: 19.1

Clang: 3.9

提案: P0189R1

C++17之前的标准下，有如下代码：

struct SomeInts
{
   bool empty();
   void push_back(int);
   //etc
};

void random_fill(SomeInts & container,
      int min, int max, int count)
{
   container.empty(); // empty it first
   for (int num : gen_rand(min, max, count))
      container.push_back(num);
}

在C++17时可以这样写：

struct SomeInts
{
   [[nodiscard]] bool empty();
   void push_back(int);
   //etc
};

void random_fill(SomeInts & container,
      int min, int max, int count)
{
   container.empty(); // empty it first
   for (int num : gen_rand(min, max, count))
      container.push_back(num);
}

加上[[nodiscard]]后，编译器发现empty()函数被调用时并没有使用它的返回值，则会报一个诸如warning: ignoring return value of 'bool empty()'的警告。

除了可以用在函数上，也可以用在类或结构体上，作用是该类或结构体被作为返回值类型时，如果不使用该返回值，则编译器警告。例如：

struct [[nodiscard]] MyError {
  std::string message;
  int code;
};

MyError divide(int a, int b) {
  if (b == 0) {
    return {"Division by zero", -1};
  }

  std::cout << (a / b) << '\n';

  return {};
}

divide(1, 2);

报警告warning: ignoring return value of function declared with 'nodiscard' attribute。

建议要谨慎考虑是否真的需要使用[[nodiscard]]属性，如果确实任何情况下都没理由可以忽略掉返回值，则可以使用。