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

CKTIS / JavaScript

Atribuição com deslocamento para a esquerda (<<=)

O operador `<<=` desloca os bits de um valor para a esquerda e atribui o resultado ao destino. O valor guardado no destino pode diferir do resultado do deslocamento. Com `Number`, o deslocamento usa 32 bits; com `BigInt`, o resultado não é truncado para 32 bits.

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 <<= shiftCount

target <<= shiftCount lê o valor do destino, executa o deslocamento << e atribui o resultado ao destino. A expressão devolve o resultado do deslocamento, mesmo que esse valor seja convertido ao ser escrito no destino. Por exemplo, se um elemento de um Uint8Array contiver 128, deslocá-lo um bit para a esquerda com <<= dá 256 como valor da expressão, mas guarda 0 no elemento. A expressão é semelhante a target = target << shiftCount, mas avalia o lado esquerdo apenas uma vez — algo importante, por exemplo, ao aceder a propriedades com efeitos secundários. O destino tem de permitir atribuição; uma variável declarada com const não pode ser atualizada desta forma.

Para Number, o valor à esquerda é convertido num inteiro com sinal de 32 bits. O contador é convertido num inteiro sem sinal de 32 bits e, em seguida, reduzido módulo 32. Entram zeros pela direita e são descartados os bits deslocados para além das 32 posições. Assim, deslocar 32 posições equivale a deslocar 0, e o resultado pode ser negativo. Esta operação não é um substituto geral da multiplicação por uma potência de dois.

Após a conversão numérica, ambos os operandos têm de ser do tipo Number ou ambos do tipo BigInt; misturar estes tipos provoca um TypeError. Com BigInt, não há truncagem para 32 bits nem redução do contador módulo 32, e um contador negativo significa um deslocamento para a direita.

No exemplo, deslocar 3 por 2 posições produz 12; result recebe esse mesmo valor. O caso wrapped demonstra a redução do contador módulo 32, enquanto wide mostra que não há truncagem para 32 bits com BigInt.

Exemplos

let mask = 3;
const result = (mask <<= 2);
console.log(mask, result);

let wrapped = 1;
wrapped <<= 32;
console.log(wrapped);

let wide = 1n;
wide <<= 32n;
console.log(String(wide));

Resultado

12 12
1
4294967296

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