Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / JavaScript

NOT bit a bit (~)

O operador unário ~ inverte os bits de um valor numérico. Com Number, opera sobre um inteiro com sinal de 32 bits; com BigInt, não limita o valor a 32 bits. Não deve ser confundido com o NOT lógico (!).

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

Sintaxe

~expression

O operador ~expression inverte cada bit: 0 passa a 1 e 1 passa a 0. Primeiro, efetua a conversão ToNumeric e, em seguida, seleciona a operação para Number ou BigInt. O resultado mantém o tipo numérico selecionado. Em contrapartida, ! efetua uma negação lógica e devolve um valor do tipo boolean.

Com Number, o operando passa pela conversão ToInt32: a parte fracionária é truncada em direção a zero e o valor regressa ao intervalo dos inteiros com sinal de 32 bits. NaN, ambos os infinitos e ambos os zeros passam a 0. Em seguida, os 32 bits são invertidos. Assim, ~5 produz -6, ~5.9 também produz -6 e ~4294967296 produz -1. Aqui, a identidade ~x = -x - 1 aplica-se ao valor após a conversão ToInt32, não a qualquer valor Number original.

Com BigInt, não há truncagem para 32 bits. A operação corresponde à representação em complemento para dois com extensão de sinal ilimitada e satisfaz ~x === -x - 1n. Por exemplo, ~5n produz -6n.

A conversão permite expressões como ~"5", que produz -6, mas um operando do tipo Symbol causa um TypeError. A expressão ~~x não é um método geral de arredondamento: com Number, devolve ToInt32(x), pelo que os valores grandes podem transbordar; com BigInt, devolve o valor original. O exemplo demonstra estas diferenças sem depender do DOM nem de outras APIs Web.

Exemplos

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

Resultado

-6
true
-6
-1
5

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes