c++17 nodiscard attribute

引用信息

C++ attribute: nodiscard
C++17新特性个人总结
What’s the reason for not using C++17’s [[nodiscard]] almost everywhere in new code?

我的理解

C++17 添加了这个属性，如果调用者丢弃了函数的返回值，刚好这个函数有nodiscard属性，或则该函数的返回类型是有nodiscard属性的类，枚举等的值类型，则编译器会报 discarding return value of function with ‘nodiscard’ attribute 的警告。
我的理解是，标记了 nodiscard 属性的函数或类等，不能被丢弃，我们调用了这类函数，就需要处理他的值，让代码更严谨。

警告成立条件

• 函数有 nodiscard 属性，或则 返回的是有 nodiscard 的值类型
• 调用者丢弃了返回值

警告不成立

• 函数,返回类没有 nodiscard 属性
• 必须返回的是值类型 ,引用类型不算
• 必须是丢弃了返回值，如果返回值参与了其他表达式运算也不算

适用的场景

• 函数返回的类型有资源的申请，需要外面去手动释放资源，直接丢弃会导致泄露
• 返回的值类型创建比较复杂，如果不用，是浪费了CPU的，提醒调用是否需要换另外更高效的函数
• 返回值很重要，例如一些重要的状态值，不处理会有很大的风险

测试代码

#include<iostream>
#include<string>

struct [[nodiscard]] NoDiscardClass
{
	std::string mString {"mstring"};
};

[[nodiscard]] std::string  NoDiscardString()
{
	return "string";
}

NoDiscardClass GetNoDiscardClass()
{
	NoDiscardClass ret;
	ret.mString = "GetNoDiscardClass";
	return ret;
}

[[nodiscard]]
std::string operator+(const std::string& theString, const NoDiscardClass& theClass)
{
	return theClass.mString + theString;
}

NoDiscardClass& GetNoDiscardClassRef()
{
	static NoDiscardClass retV{"Ref"};
	return retV;
}

int main()
{
	//warning: discarding return value of function with 'nodiscard' attribute
	GetNoDiscardClass();  // warning
	GetNoDiscardClassRef(); //no warning
	NoDiscardClass temp = GetNoDiscardClass(); //no warning
	NoDiscardString(); //warning
	std::string tempStr = NoDiscardString() + temp + GetNoDiscardClass(); //no warning
	tempStr = tempStr + GetNoDiscardClassRef();//no warning
	std::cout << tempStr << std::endl;	
	return 0;
}

总结

当觉得返回值是非常有意义，需要调用者重视并处理的，果断添加这个属性吧，当觉得返回值不那么重要，那么就直接返回void多好。