CKTIS / JavaScript
Operátor zbytku po dělení (%)
Operátor % vypočítá zbytek pro hodnoty typu Number nebo BigInt. Nenulový výsledek má znaménko dělence, takže u záporných čísel se zbytek liší od nezáporného modulo. Je třeba dávat pozor na typy operandů a dělení nulou.
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
dividend % divisorVe výrazu dividend % divisor je levý operand dělenec a pravý dělitel. U konečných hodnot a nenulového dělitele odpovídá zbytek výsledku, který získáme odečtením součinu dělitele a podílu zaokrouhleného směrem k nule od dělence. Nenulový výsledek má znaménko dělence: -13 % 5 je -3, zatímco 13 % -5 je 3. % neznamená procenta.
Zbytek není totéž co nezáporné modulo. U celočíselných hodnot Number v bezpečném rozsahu a kladného dělitele lze výsledek normalizovat výrazem ((dividend % divisor) + divisor) % divisor; zohledněte také bezpečný rozsah mezisoučtu. Pro -13 a 5 vyjde 2.
Operandy se převedou na číselné hodnoty; po převodu musí být oba typu Number, nebo oba typu BigInt. Kombinace těchto typů vyvolá TypeError. Number umožňuje zlomky, například 5.5 % 2 je 1.5, ale podléhá omezením přesnosti čísel s plovoucí desetinnou čárkou. BigInt pracuje s celými čísly.
Pro Number způsobí dělitel 0 nebo -0, operand NaN nebo nekonečný dělenec výsledek NaN. Konečný dělenec s nekonečným dělitelem zůstane beze změny. Záporný dělenec může dát -0, který lze zjistit pomocí Object.is(result, -0). Pro BigInt vyvolá dělitel 0n chybu RangeError; tento typ nemá -0.
% má stejnou prioritu jako * a /, vyšší než + a -; operátory této skupiny se vyhodnocují zleva doprava. Patří do jazyka ECMAScript, nikoli do Web API. Příklad vyžaduje prostředí podporující BigInt.
Příklady
const dividend = -13;
const divisor = 5;
console.log(dividend % divisor);
console.log(((dividend % divisor) + divisor) % divisor);
console.log(5.5 % 2);
console.log(String(13n % 5n));
console.log(Object.is(-10 % 5, -0));
console.log(Number.isNaN(10 % 0));Výsledek
-3 2 1.5 3 true true
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.