WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Bitweises NOT (~)

Der unäre Operator ~ invertiert die Bits eines Zahlenwerts. Bei Number arbeitet er mit einer vorzeichenbehafteten 32-Bit-Ganzzahl; bei BigInt wird der Wert nicht auf 32 Bit beschränkt. Nicht mit dem logischen NOT (!) verwechseln.

Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

~expression

Der Operator ~expression invertiert jedes Bit: Aus 0 wird 1 und aus 1 wird 0. Zuerst führt er eine ToNumeric-Konvertierung aus und wählt anschließend die Operation für Number oder BigInt. Das Ergebnis behält den gewählten Zahlentyp bei. Im Gegensatz dazu führt ! eine logische Negation aus und gibt einen Wert vom Typ boolean zurück.

Bei Number wird der Operand mit ToInt32 konvertiert: Der Nachkommateil wird in Richtung null abgeschnitten und der Wert in den Bereich vorzeichenbehafteter 32-Bit-Ganzzahlen zurückgeführt. NaN, beide Unendlichkeiten und beide Nullen werden zu 0. Danach werden alle 32 Bits invertiert. Daher ergibt ~5 den Wert -6, ~5.9 ebenfalls -6 und ~4294967296 den Wert -1. Die Identität ~x = -x - 1 gilt hier für den Wert nach der ToInt32-Konvertierung, nicht für einen beliebigen ursprünglichen Number-Wert.

Bei BigInt gibt es keine Beschränkung auf 32 Bit. Die Operation entspricht der Zweierkomplementdarstellung mit unbegrenzter Vorzeichenerweiterung und erfüllt ~x === -x - 1n. Zum Beispiel ergibt ~5n den Wert -6n.

Die Konvertierung ermöglicht beispielsweise ~"5", was -6 ergibt; ein Operand vom Typ Symbol verursacht jedoch einen TypeError. Die Schreibweise ~~x ist keine allgemeine Rundungsmethode: Bei Number gibt sie ToInt32(x) zurück, sodass große Werte überlaufen können; bei BigInt gibt sie den ursprünglichen Wert zurück. Das Beispiel zeigt diese Unterschiede, ohne vom DOM oder anderen Web-APIs abhängig zu sein.

Beispiele

const value = 5;
console.log(~value);
console.log(~5n === -6n);
console.log(~5.9);
console.log(~4294967296);
console.log(~~5.9);

Ergebnis

-6
true
-6
-1
5

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