详解C++17中nodiscard标记符的使用

下面是详解C++17中nodiscard标记符的使用的完整攻略。

什么是nodiscard标记符？

nodiscard是C++17标准引入的一个标记符，在函数声明或定义中加入它可以告诉编译器该函数的返回值不能被忽略。在使用nodiscard标记符的情况下，如果函数返回值被忽略，编译器将给出警告。

when和where to use nodiscard标记符？

在以下情况下，适合使用nodiscard标记符：

• 对于某些函数，调用者需要检查返回值是否为特定值或是否存在错误。
• 对于某些函数，如果返回值被忽略，将清除一些状态或资源，这可能导致问题。

例如：

[[nodiscard]] int open_file(const char* filename);

这里我们使用了nodiscard标记符，因为open_file函数返回文件句柄，如果文件句柄没被关闭（显式的close_file(email + filename)命令），将会导致文件泄露。

如何使用nodiscard标记符？

示例1：

#include <iostream>
#include <string>
[[nodiscard]] int add(int a, int b) // 声明nodiscard
{
    return a + b;
}
int main()
{
    int result = add(1, 2); // 添加nodiscard没有警告
    add(3, 4); // 忽略返回值
    return 0;
}

当执行上述程序时，编译器会发出下面的警告：

warning: ignoring return value of function declared with 'nodiscard' attribute [-Wunused-result]
add(3, 4); // ignore the return value of function without warning

示例2：

也可以将属性注释提供给类或结构体的结构体一部分。

class [[nodiscard]] MyApi {
public:
    [[nodiscard]] int Exec(const std::wstring& command);
};

在这种情况下，任何使用MyAPI::Exec的调用都将需要检查结果。

总结

总之，nodiscard标记符的使用可以帮助代码更加健壮且避免潜在的问题，特别是对库开发者来说，这是非常有用的。