CKTIS / JavaScript
Bitové OR s přiřazením (|=)
Operátor |= provede bitové OR mezi aktuální hodnotou cíle a pravým operandem a výsledek přiřadí cíli. Umožňuje nastavit bity vybrané maskou, aniž by vynuloval ostatní; podporuje Number i BigInt.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
target |= expressiontarget |= expression vypočítá bitové OR (|) aktuální hodnoty cíle a pravého operandu a výsledek přiřadí cíli. Pokud přiřazení proběhne bez chyby, hodnotou výrazu je vypočtený výsledek bitového OR. Setter vlastnosti může skončit bez chyby, aniž by předanou hodnotu uložil. I v takovém případě je hodnotou výrazu vypočtený výsledek. Bit výsledku je 1, pokud je 1 alespoň jeden z odpovídajících bitů operandů. Typickým použitím je zapínání příznaků pomocí masky.
U jednoduché proměnné se flags |= mask chová jako flags = flags | mask, výraz určující cíl se však vyhodnotí pouze jednou. To je důležité při přístupu k vlastnostem s vedlejšími účinky. Mimo striktní režim může přiřazení pomocí |= do nezapisovatelné datové vlastnosti proběhnout bez chyby: vlastnost zůstane beze změny a hodnotou výrazu je vypočtený výsledek bitového OR. Ve striktním režimu takový pokus o zápis vyvolá TypeError. Pokus o změnu proměnné deklarované pomocí const vyvolá TypeError v obou režimech.
Operandy se převedou na číselný typ. U Number je operace převede na 32bitová celá čísla se znaménkem: zahodí desetinnou část a zachová dolních 32 bitů. Výsledek je také 32bitové celé číslo se znaménkem, takže může být záporný. U BigInt se limit 32 bitů neuplatní. Po převodu musí mít oba operandy stejný číselný typ; kombinace Number a BigInt vyvolá TypeError.
Nezaměňujte |= s logickým OR přiřazením (||=). |= neprovádí zkrácené vyhodnocení podle pravdivostní hodnoty levé strany; při běžném průběhu se vyhodnotí pravý operand a provede se přiřazení. V příkladu dává výraz 0b0001 | 0b0100 hodnotu 0b0101, tedy 5. Opětovné použití stejné masky ponechá tyto bity zapnuté.
Příklady
let flags = 0b0001;
const mask = 0b0100;
const result = (flags |= mask);
console.log(flags);
console.log(result);
flags |= mask;
console.log(flags);Výsledek
5 5 5
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.