C++ Attribut: maybe_unused (seit C++17)

 

C++

Compiler-Unterstützung

Freestanding und gehostet

Sprache

Standardbibliothek

Header der Standardbibliothek

Benannte Anforderungen

Feature-Test-Makros (C++20)

Bibliothek für Sprachunterstützung

Konzepte-Bibliothek (C++20)

Diagnostik-Bibliothek

Speicherverwaltungsbibliothek

Metaprogrammierungsbibliothek (C++11)

Allgemeine Dienstprogramme-Bibliothek

Container-Bibliothek

Iterator-Bibliothek

Ranges-Bibliothek (C++20)

Algorithmen-Bibliothek

Bibliothek für Zeichenketten

Textverarbeitungsbibliothek

Numerik-Bibliothek

Datums- und Zeitbibliothek

Ein-/Ausgabe-Bibliothek

Dateisystembibliothek (C++17)

Unterstützung für nebenläufige Programmierung (C++11)

Ausführungssteuerungsbibliothek (C++26)

Technische Spezifikationen

Symbolverzeichnis

Externe Bibliotheken

 

C++ Sprache

Allgemeine Themen
Präprozessor Kommentare	Schlüsselwörter Escape-Sequenzen
Kontrollfluss
Bedingte Ausführungsaussagen
if	switch
Iterationsanweisungen (Schleifen)
for Bereichs-for (C++11)	while do-while
Sprunganweisungen
continue - break	goto - return
Funktionen
Funktionsdeklaration
Lambda-Funktionsausdruck
inline-Spezifizierer
Dynamische Ausnahmespezifikationen (bis C++17*)
noexcept-Spezifizierer (C++11)
Ausnahmen
throw-Ausdruck try-Block	catch-Handler
Namensräume
Namensdeklaration	Namensaliase
Typen
Fundamentale Typen Aufzählungstypen Funktionstypen	Klassen-/Strukturtypen Union-Typen
Spezifizierer
const/volatile decltype (C++11) auto (C++11)	constexpr (C++11) consteval (C++20) constinit (C++20)
Speicherdauer-Spezifizierer
Initialisierung
Standardinitialisierung Wertinitialisierung Nullinitialisierung Kopierinitialisierung Direkte Initialisierung	Aggregatinitialisierung Listeninitialisierung (C++11)   Konstante Initialisierung Referenzinitialisierung

Ausdrücke
Wertkategorien Reihenfolge der Auswertung	Operatoren Operatorrangfolge
Alternative Darstellungen
Literale
Boolesch - Ganzzahl - Gleitkommazahl
Zeichen - String - nullptr (C++11)
Benutzerdefinierte (C++11)
Dienstprogramme
Attribute (C++11)
Typen
typedef-Deklaration
Typalias-Deklaration (C++11)
Umwandlungen
Implizite Konvertierungen static_cast const_cast	Explizite Konvertierungen dynamic_cast reinterpret_cast
Speicherzuweisung
new-Ausdruck	delete-Ausdruck
Klassen
Klassendeklaration Konstruktoren this-Zeiger	Zugriffsspezifizierer friend-Spezifizierer
Klassenspezifische Funktionseigenschaften
Virtuelle Funktion override-Spezifizierer (C++11)   final-Spezifizierer (C++11)	explicit (C++11) static
Spezielle Member-Funktionen
Standardkonstruktor Kopierkonstruktor Move-Konstruktor (C++11)	Kopierzuweisung Move-Zuweisung (C++11) Destruktor
Templates
Klassenschablone Funktionsschablone	Schablonenspezialisierung Parameter-Pakete (C++11)
Sonstiges
Inline-Assembler	Geschichte von C++

 

Deklarationen

Übersicht Deklarationssyntax decl-specifier-seq Deklarator Konfligierende Deklarationen Spezifizierer typedef inline virtual Funktionsspezifizierer explicit Funktionsspezifizierer friend constexpr (C++11) consteval (C++20) constinit (C++20) Speicherklassen-Spezifizierer Übersetzungseinheits-lokal (C++20) class/struct union enum decltype (C++11) auto (C++11) alignas (C++11) constvolatile Pack-Indizierungs-Spezifizierer (C++26)     Elaborierter Typ-Spezifizierer Attribute (C++11)

Deklaratoren Referenz Zeiger Array Blockdeklarationen Einfache Deklaration   →Strukturierte Bindungsdeklaration (C++17) Alias-Deklaration (C++11) Namespace-Alias-Definition using Deklaration using-Direktive static_assert-Deklaration (C++11) asm-Deklaration Opaque Enum-Deklaration (C++11) Andere Deklarationen Namespace-Definition Funktionsdeklaration Klassentemplatedeklaration Funktionstemplatedeklaration Explizite Template-Instanziierung (C++11) Explizite Templatespezialisierung Linkage-Spezifikation Attributdeklaration (seit C++11) Leere Deklaration

 

Attribute

assume (C++23)

carries_dependency (C++11)(bis C++26)

deprecated (C++14)

fallthrough (C++17)

indeterminate (C++26)

likely (C++20)

maybe_unused (C++17)

nodiscard (C++17)

noreturn (C++11)

no_unique_address (C++20)

optimize_for_synchronized (TM TS)

unlikely (C++20)

 

Unterdrückt Warnungen bei ungenutzten Entitäten.

Syntax

[[maybe_unused]]

Erklärung

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

• Klasse: struct [[maybe_unused]] S;
• typedef, einschließlich der durch Alias-Deklaration deklarierten: [[maybe_unused]] typedef S* PS;, using PS [[maybe_unused]] = S*;
• Variable, einschließlich statischer Datenmember: [[maybe_unused]] int x;
• Nicht-statischer Datenmember: union U { [[maybe_unused]] int n; };,
• Funktion: [[maybe_unused]] void f();
• Aufzählung: enum [[maybe_unused]] E {};
• Aufzählungselement: enum { A [[maybe_unused]], B [[maybe_unused]] = 42 };
• Strukturierte Bindung: [[maybe_unused]] auto [a, b] = std::make_pair(42, 0.23);

Ergebnisbindung: post(r [[maybe_unused]] : this->empty())

(seit C++26)

Bei Entitäten, die mit [[maybe_unused]] deklariert werden, wird die vom Compiler ausgegebene Warnung bezüglich ungenutzter Entitäten oder deren strukturierter Bindungen unterdrückt, falls diese nicht genutzt werden.

Bei Labels, die mit [[maybe_unused]] deklariert werden, wird die vom Compiler ausgegebene Warnung bezüglich ungenutzter Labels unterdrückt, falls diese nicht genutzt werden.

(seit C++26)

Beispiel

Führen Sie diesen Code aus

#include <cassert>
 
[[maybe_unused]] void f([[maybe_unused]] bool thing1,
                        [[maybe_unused]] bool thing2)
{
    [[maybe_unused]] lbl: // the label “lbl” is not used, no warning
    [[maybe_unused]] bool b = not false and not true;
    assert(b); // in release mode, assert is compiled out, and “b” is unused
               // no warning because it is declared [[maybe_unused]]
} // parameters “thing1” and “thing2” are not used, no warning
 
int main() {}

Defect reports

Die folgenden Verhaltensändernden Fehlerberichte wurden rückwirkend auf zuvor veröffentlichte C++-Standards angewendet.

DR	angewendet auf	Verhalten wie veröffentlicht	Korrigiertes Verhalten
CWG 2360	C++17	could not apply [[maybe_unused]] to structured bindings	erlaubt

Referenzen

• C++23 Standard (ISO/IEC 14882:2024)

• 9.12.8 Maybe unused attribute [dcl.attr.unused]

• C++20 Standard (ISO/IEC 14882:2020)

• 9.12.7 Maybe unused attribute [dcl.attr.unused]

• C++17 Standard (ISO/IEC 14882:2017)

• 10.6.6 Maybe unused attribute [dcl.attr.unused]

Siehe auch

C-Dokumentation für maybe_unused