CKTIS / JavaScript
Przypisanie z przesunięciem w lewo (<<=)
Operator `<<=` przesuwa bity wartości w lewo i przypisuje wynik do celu. Wartość zapisana w celu może różnić się od wyniku przesunięcia. Dla `Number` przesunięcie działa na 32 bitach, a dla `BigInt` nie ogranicza wyniku do 32 bitów.
Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Składnia
target <<= shiftCounttarget <<= shiftCount odczytuje wartość celu, wykonuje przesunięcie << i przypisuje wynik do celu. Wartością wyrażenia jest wynik przesunięcia, nawet jeśli przy zapisie do celu wartość zostanie przekształcona. Na przykład jeśli element Uint8Array zawiera 128, przesunięcie go o jeden bit w lewo za pomocą <<= daje wartość wyrażenia 256, ale w elemencie zostaje zapisane 0. Wyrażenie przypomina target = target << shiftCount, ale lewa strona jest obliczana tylko raz — ma to znaczenie przy dostępie do właściwości z efektami ubocznymi. Cel musi dopuszczać przypisanie; nie można w ten sposób zmienić zmiennej zadeklarowanej przez const.
Dla Number lewa wartość jest konwertowana do 32-bitowej liczby całkowitej ze znakiem. Licznik jest konwertowany do 32-bitowej liczby bez znaku, a następnie redukowany modulo 32. Z prawej dochodzą zera, a bity wychodzące poza 32 pozycje przepadają. Dlatego przesunięcie o 32 działa jak przesunięcie o 0, a wynik może być ujemny. To nie jest ogólny zamiennik mnożenia przez potęgę dwójki.
Po konwersji numerycznej oba argumenty muszą być typu Number albo oba typu BigInt; mieszanie tych typów powoduje TypeError. Dla BigInt nie ma obcięcia do 32 bitów ani redukcji licznika modulo 32, a ujemny licznik oznacza przesunięcie w prawo.
W przykładzie 3 przesunięte o 2 daje 12; result otrzymuje tę samą wartość. Przypadek wrapped pokazuje redukcję licznika modulo 32, a wide — brak 32-bitowego obcięcia dla BigInt.
Przykłady
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));Wynik
12 12 1 4294967296
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.