Namensräume
Varianten
Aktionen

C-Attribut: maybe_unused (seit C23)

Von cppreference.com
< c‎ | Sprache‎ | Attribute

Unterdrückt Warnungen für ungenutzte Entitäten.

Inhalt

[bearbeiten] Syntax

[[ maybe_unused ]]
[[ __maybe_unused__ ]]

[bearbeiten] 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;,
  • Struktur-/Union-Mitglied: union U { [[maybe_unused]] int n; };,
  • Funktion: [[maybe_unused]] void f(void);,
  • Aufzählung: enum [[maybe_unused]] E {};,
  • Aufzählungselement: enum { A [[maybe_unused]], B [[maybe_unused]] = 42 };.

Wenn der Compiler Warnungen für ungenutzte Entitäten ausgibt, wird diese Warnung für jede als maybe_unused deklarierte Entität unterdrückt.

[bearbeiten] Beispiel

#include <assert.h>
 
[[maybe_unused]] void f([[maybe_unused]] _Bool cond1, [[maybe_unused]] _Bool cond2)
{
   [[maybe_unused]] _Bool b = cond1 && cond2;
   assert(b); // in release mode, assert is compiled out, and b is unused
              // no warning because it is declared [[maybe_unused]]
} // parameters cond1 and cond2 are not used, no warning
 
int main(void)
{
    f(1, 1);
}

[bearbeiten] Siehe auch

C++ Dokumentation für maybe_unused