Q_REQUIRED_RESULT做什么?

时间:2017-02-14 12:04:44

标签: c++ qt qt4

我刚刚阅读了Qt4源代码,发现预编译器在qstring.h(以及其他位置)多次定义Q_REQUIRED_RESULT

它实际上做了什么,为什么没有记录(适合here)?

定义如下:

#ifndef Q_REQUIRED_RESULT
#  if defined(Q_CC_GNU) && !defined(Q_CC_INTEL) && (__GNUC__ > 4 || (__GNUC__ == 4 && __GNUC_MINOR__ >= 1))
#    define Q_REQUIRED_RESULT __attribute__ ((warn_unused_result))
#  else
#    define Q_REQUIRED_RESULT
#  endif
#endif

1 个答案:

答案 0 :(得分:7)

如果您不使用函数的返回值,它会使编译器生成警告,因为它可能是您犯了错误。 E.g:

QString str("hello, world!");
str.toUpper();

// str is still lower case, the upper case version has been
// *returned* from toUpper() and lost. the compiler should warn about this!

在C ++ 17中,这已在[[nodiscard]] attribute下标准化。它没有记录,因为它不是公共API - 即在代码中冒风险使用它,Qt可以随时更改它。 (好吧,极不可能,但仍有可能)。