CKTIS / JavaScript
Restoperator (%)
De operator % berekent de rest voor waarden van het type Number of BigInt. Een resultaat dat niet nul is, heeft het teken van het deeltal; bij negatieve getallen verschilt de rest daarom van een niet-negatieve modulo. Let goed op de operandtypen en delen door nul.
Versie: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
dividend % divisorIn dividend % divisor is de linker operand het deeltal en de rechter operand de deler. Bij eindige waarden en een deler die niet nul is, komt de rest overeen met het deeltal min de deler vermenigvuldigd met het quotiënt dat in de richting van nul is afgekapt. Een resultaat dat niet nul is, heeft het teken van het deeltal: -13 % 5 is -3, terwijl 13 % -5 3 is. % betekent geen percentage.
Rest is niet hetzelfde als een niet-negatieve modulo. Voor gehele Number-waarden binnen het veilige bereik en een positieve deler kun je normaliseren met ((dividend % divisor) + divisor) % divisor; houd ook rekening met het veilige bereik van de tussentijdse som. Voor -13 en 5 levert dit 2 op.
Operanden worden omgezet naar numerieke waarden; na de omzetting moeten ze allebei van het type Number of allebei van het type BigInt zijn. Deze typen mengen veroorzaakt een TypeError. Number staat breuken toe, bijvoorbeeld is 5.5 % 2 gelijk aan 1.5, maar kent beperkingen door de precisie van drijvende komma’s. BigInt werkt met gehele getallen.
Bij Number levert een deler van 0 of -0, een NaN-operand of een oneindig deeltal NaN op. Een eindig deeltal met een oneindige deler blijft ongewijzigd. Een negatief deeltal kan -0 opleveren, te herkennen met Object.is(result, -0). Bij BigInt veroorzaakt een deler van 0n een RangeError; dit type kent geen -0.
% heeft dezelfde prioriteit als * en /, hoger dan die van + en -; operatoren in deze groep associëren van links naar rechts. De operator hoort bij de ECMAScript-taal en is geen Web API. Het voorbeeld vereist een omgeving met ondersteuning voor BigInt.
Voorbeelden
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));Resultaat
-3 2 1.5 3 true true
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.