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

CKTIS / JavaScript

Atribuição XOR bit a bit (^=)

O operador ^= calcula o OU exclusivo bit a bit entre o valor atual do destino e o operando à direita e, em seguida, atribui o resultado a esse mesmo destino. Permite, por exemplo, alternar bits com uma máscara. Suporta Number e BigInt, mas não permite misturar estes tipos.

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

target ^= expression

target ^= expression efetua um XOR bit a bit e atribui o resultado a target. Cada bit do resultado é 1 quando os bits correspondentes dos operandos são diferentes, e 0 quando são iguais. Assim, uma máscara alterna os bits assinalados com 1 e deixa os restantes inalterados. Não se trata de exponenciação nem de um operador lógico aplicado a valores de verdade.

Para uma variável simples, x ^= y produz o mesmo resultado que x = x ^ y, mas avalia o lado esquerdo apenas uma vez. Isto é relevante no acesso a propriedades com efeitos secundários. O valor atual do destino é lido antes de o lado direito ser avaliado. A expressão de atribuição devolve o valor calculado pelo XOR, mesmo que o setter de uma propriedade aceite a escrita sem guardar o valor. Isto também pode acontecer sem um setter: fora do modo estrito, uma tentativa de escrita numa propriedade de dados que não permite escrita é ignorada, mas a expressão devolve na mesma o resultado do XOR. Em modo estrito, essa tentativa provoca um TypeError.

Os operandos são convertidos em valores numéricos. Com Number, XOR opera sobre inteiros com sinal de 32 bits: as partes fracionárias são descartadas e os valores fora do intervalo são ajustados a 32 bits. Com BigInt, não existe limite de 32 bits. Após a conversão, os dois operandos têm de ter o mesmo tipo numérico; combinar Number e BigInt provoca um TypeError.

No exemplo, 0b1010 XOR 0b0110 produz 0b1100, ou seja, 12. Ao aplicar novamente a mesma máscara, obtém-se 10. A parte BigInt produz o mesmo resultado numérico, enquanto String(wide) torna o texto de saída inequívoco.

Exemplos

let flags = 0b1010;
const mask = 0b0110;
console.log(flags ^= mask);
console.log(flags ^= mask);

let wide = 10n;
wide ^= 6n;
console.log(String(wide));

Resultado

12
10
12

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