CKTIS / JavaScript
Przypisanie z przesunięciem w prawo bez znaku (>>>=)
Operator >>>= przesuwa 32-bitową reprezentację wartości w prawo, wypełnia wolne bity zerami i zapisuje wynik w lewym operandzie. W przeciwieństwie do >>= nie zachowuje bitu znaku. Nie obsługuje BigInt.
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 łączy przesunięcie >>> z przypisaniem. Dla zwykłej zmiennej działa jak target = target >>> shiftCount, ale cel przypisania jest obliczany tylko raz. Wyrażenie zwraca obliczony wynik przesunięcia, który może się różnić od wartości zapisanej po konwersji. Na przykład zastosowanie >>>= 0 do elementu Int8Array o wartości -1 zwraca 4294967295, ale po konwersji przy zapisie element nadal ma wartość -1. Aby zapis się powiódł, cel musi go umożliwiać. Poza trybem ścisłym przypisanie do właściwości danych, która nie pozwala na zapis, może się nie powieść bez zgłoszenia błędu, a wyrażenie mimo to zwróci obliczony wynik przesunięcia. Przypisanie do zmiennej zadeklarowanej przez const zgłasza TypeError.
Operacja konwertuje operandy liczbowo, a następnie stosuje ToUint32 do obu wartości typu Number. Liczba przesunięć to prawy operand po tej konwersji modulo 32, więc 34 oznacza przesunięcie o 2 bity. Wynik jest wartością Number z zakresu od 0 do 4294967295, a nie osobnym typem liczby bez znaku.
W przeciwieństwie do >>=, operator >>>= wstawia zera zamiast powielać bit znaku. Ujemne wejście może więc dać dużą liczbę dodatnią. Konwersja do 32 bitów może utracić część ułamkową i starsze bity; nie jest to ogólne dzielenie przez potęgę dwójki. Nawet przesunięcie o 0 wykonuje konwersję.
BigInt nie obsługuje tego operatora: zarówno dwa operandy BigInt, jak i mieszanka BigInt oraz Number powodują TypeError. Przykład pokazuje wynik przypisania, różnicę względem >> oraz redukcję liczby przesunięć modulo 32.
Przykłady
let value = -8;
const result = (value >>>= 1);
console.log(value);
console.log(result);
console.log(-8 >> 1);
let wrapped = 16;
wrapped >>>= 34;
console.log(wrapped);Wynik
2147483644 2147483644 -4 4
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.