C++ attribute: nodiscard (since C++17)

Si una función declarada nodiscard o una función que retorna una enumeración o clase declarada nodiscard por valor es llamada desde una expresión de valor descartado que no sea una conversión a void , se recomienda al compilador que emita una advertencia.

Sintaxis

Explicación

Aparece en una declaración de función, declaración de enumeración o declaración de clase.

Si, desde una expresión de valor descartado que no sea un cast a void ,

• se llama a una función declarada nodiscard , o
• se llama a una función que devuelve una enumeración o clase declarada nodiscard por valor, o
• se llama a un constructor declarado nodiscard mediante conversión explícita de tipo o static_cast , o
• se inicializa un objeto de tipo enumeración o clase declarado nodiscard mediante conversión explícita de tipo o static_cast ,

se recomienda al compilador que emita una advertencia.

Ejemplo

struct [[nodiscard]] error_info { /*...*/ };
error_info enable_missile_safety_mode() { /*...*/ return {}; }
void launch_missiles() { /*...*/ }
void test_missiles()
{
    enable_missile_safety_mode(); // el compilador puede advertir al descartar un valor nodiscard
    launch_missiles();
}
error_info& foo() { static error_info e; /*...*/ return e; }
void f1() { foo(); } // el tipo nodiscard no se retorna por valor, sin advertencia
// nodiscard( cadena-de-caracteres ) (desde C++20):
[[nodiscard("PURE FUN")]] int strategic_value(int x, int y) { return x ^ y; }
int main()
{
    strategic_value(4, 2); // el compilador puede advertir al descartar un valor nodiscard
    auto z = strategic_value(0, 0); // OK: el valor de retorno no se descarta
    return z;
}

game.cpp:5:4: warning: ignoring return value of function declared with ⮠
 'nodiscard' attribute
game.cpp:17:5: warning: ignoring return value of function declared with ⮠
 'nodiscard' attribute: PURE FUN

Informes de defectos

Los siguientes informes de defectos que modifican el comportamiento se aplicaron retroactivamente a los estándares de C++ publicados anteriormente.

Referencias

Véase también