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 | rhsDer 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.