CKTIS / JavaScript
Bitovni OR s dodjelom (|=)
Operator |= izvodi bitovni OR između trenutačne vrijednosti cilja i desnog operanda, a zatim dodjeljuje rezultat cilju. Omogućuje postavljanje bitova odabranih maskom bez poništavanja ostalih; podržava Number i BigInt.
Verzija: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
target |= expressiontarget |= expression izračunava bitovni OR (|) trenutačne vrijednosti cilja i desnog operanda, a zatim dodjeljuje rezultat cilju. Ako se dodjela dovrši bez pogreške, vrijednost izraza jest izračunani rezultat bitovnog OR-a. Setter svojstva može završiti bez pogreške, a da ne pohrani primljenu vrijednost. I tada je vrijednost izraza izračunani rezultat. Bit rezultata ima vrijednost 1 ako je barem jedan od odgovarajućih bitova operanada 1. Uobičajena je primjena uključivanje zastavica pomoću maske.
Za jednostavnu varijablu flags |= mask ponaša se kao flags = flags | mask, ali izraz koji određuje cilj izračunava se samo jednom. To je važno pri pristupu svojstvima sa sporednim učincima. Izvan strogog načina rada dodjela operatorom |= podatkovnom svojstvu koje ne dopušta pisanje može završiti bez pogreške: svojstvo ostaje nepromijenjeno, a vrijednost izraza jest izračunani rezultat bitovnog OR-a. U strogom načinu rada takav pokušaj pisanja uzrokuje TypeError. Pokušaj izmjene varijable deklarirane s const uzrokuje TypeError u oba načina rada.
Operandi se pretvaraju u numerički tip. Za Number operacija ih pretvara u predznačene 32-bitne cijele brojeve: odbacuje decimalne dijelove i zadržava donja 32 bita. Rezultat je također predznačeni 32-bitni cijeli broj pa može biti negativan. Za BigInt nema ograničenja od 32 bita. Nakon pretvorbe oba operanda moraju biti istog numeričkog tipa; kombiniranje Number i BigInt uzrokuje TypeError.
Nemojte brkati |= s logičkom OR dodjelom (||=). |= ne preskače vrednovanje desnog operanda ovisno o tome smatra li se lijeva vrijednost istinitom ili neistinitom: pri uobičajenom vrednovanju vrednuje se desni operand i izvršava se dodjela. U primjeru 0b0001 | 0b0100 daje 0b0101, odnosno 5. Ponovna primjena iste maske ostavlja te bitove uključenima.
Primjeri
let flags = 0b0001;
const mask = 0b0100;
const result = (flags |= mask);
console.log(flags);
console.log(result);
flags |= mask;
console.log(flags);Rezultat
5 5 5
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.