C attribute: maybe_unused (since C23)

Unterdrückt Warnungen zu nicht verwendeten Entitäten.

Syntax

Erklärung

Dieses Attribut kann in der Deklaration der folgenden Entitäten erscheinen:

• struct / union : struct [ [ maybe_unused ] ] S ; ,
• Typedef-Name : [ [ maybe_unused ] ] typedef S * PS ; ,
• Objekt: [ [ maybe_unused ] ] int x ; ,
• Struct/Union-Mitglied: union U { [ [ maybe_unused ] ] int n ; } ; ,
• Funktion : [ [ maybe_unused ] ] void f ( void ) ; ,
• Enumeration : enum [ [ maybe_unused ] ] E { } ; ,
• Enumerator: enum { A [ [ maybe_unused ] ] , B [ [ maybe_unused ] ] = 42 } ; .

Wenn der Compiler Warnungen zu ungenutzten Entitäten ausgibt, wird diese Warnung für jede Entität unterdrückt, die als maybe_unused deklariert ist.

Beispiel

#include <assert.h>
[[maybe_unused]] void f([[maybe_unused]] _Bool cond1, [[maybe_unused]] _Bool cond2)
{
   [[maybe_unused]] _Bool b = cond1 && cond2;
   assert(b); // im Release-Modus wird assert entfernt und b nicht verwendet
              // keine Warnung, da es als [[maybe_unused]] deklariert ist
} // Parameter cond1 und cond2 werden nicht verwendet, keine Warnung
int main(void)
{
    f(1, 1);
}

Siehe auch