WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C++

Bitweiser ODER-Operator |

Der Operator | verknüpft die entsprechenden Bits zweier Werte: Ein Ergebnisbit ist 1, wenn mindestens eines der Eingabebits 1 ist. Er eignet sich unter anderem zum Kombinieren von Flag-Masken und ist nicht mit dem logischen Operator || zu verwechseln.

Version: C++23; repository compiler flag, production runtime not attested

Syntax

lhs | rhs

Der eingebaute Operator | führt ein bitweises inklusives ODER aus: An jeder Bitposition ergibt sich nur dann 0, wenn beide Bits 0 sind. Andernfalls ergibt sich 1, auch wenn beide Bits 1 sind. Zum Beispiel ergibt 0b0100u | 0b0010u den Wert 0b0110u, also 6.

Die Operanden müssen ganzzahlige Typen oder nicht bereichsgebundene Aufzählungstypen haben. Der eingebaute Operator | akzeptiert keine Werte von enum class direkt. Er wendet die üblichen arithmetischen Konvertierungen an, einschließlich Ganzzahl-Promotionen; der gemeinsame konvertierte Typ ist der Ergebnistyp. Daher muss das Ergebnis nicht den schmalen Typ eines Operanden beibehalten. Für einfache Masken sind zueinander passende vorzeichenlose Typen vorzuziehen.

Verwechsle | nicht mit ||: Das eingebaute || gibt bool zurück und wertet den rechten Operanden nicht aus, wenn der linke wahr ist. Das eingebaute | wertet beide Operanden aus und garantiert keine Auswertungsreihenfolge von links nach rechts. Linksassoziativität bedeutet, dass a | b | c als (a | b) | c gruppiert wird, nicht, dass die Auswertung in dieser Reihenfolge erfolgt.

Der Ausdruck a | b allein verändert weder a noch b. Um die kombinierten Bits zu speichern, verwende eine Zuweisung oder a |= b; Letzteres entspricht a = a | b, wertet den linken Operanden aber nur einmal aus. bitor ist eine alternative Schreibweise für |, während or für || steht.

Das Beispiel kombiniert die Flags read und write zu permissions und gibt 6 aus. Der static_assert prüft den erwarteten Wert während der Kompilierung. Diese Erklärung behandelt den eingebauten Operator, nicht Klassenüberladungen. Das Material richtet sich an C++23; das angegebene Dokument ist ein fortlaufend bearbeiteter Entwurf und keine unveränderliche C++23-Veröffentlichung.

Beispiele

#include <iostream>

int main() {
    constexpr unsigned int read = 0b0100u;
    constexpr unsigned int write = 0b0010u;
    constexpr unsigned int permissions = read | write;
    static_assert(permissions == 0b0110u);
    std::cout << permissions << '\n';
}

Ergebnis

6

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen