CKTIS / JavaScript
Operatore resto (%)
L’operatore % calcola il resto per valori Number o BigInt. Un risultato diverso da zero ha il segno del dividendo, quindi con numeri negativi il resto si distingue dal modulo non negativo. Occorre prestare attenzione ai tipi degli operandi e alla divisione per zero.
Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintassi
dividend % divisorIn dividend % divisor, l’operando a sinistra è il dividendo e quello a destra è il divisore. Per valori finiti e un divisore diverso da zero, il resto corrisponde a sottrarre dal dividendo il divisore moltiplicato per il quoziente troncato verso zero. Un risultato diverso da zero ha il segno del dividendo: -13 % 5 dà -3, mentre 13 % -5 dà 3. % non significa percentuale.
Il resto non equivale al modulo non negativo. Per valori Number interi entro l’intervallo sicuro e un divisore positivo, si può normalizzare con ((dividend % divisor) + divisor) % divisor; occorre considerare anche l’intervallo sicuro della somma intermedia. Per -13 e 5, il risultato è 2.
Gli operandi vengono convertiti in valori numerici; dopo la conversione, devono essere entrambi di tipo Number oppure entrambi di tipo BigInt. Mescolare questi tipi genera un TypeError. Number ammette le frazioni: per esempio, 5.5 % 2 dà 1.5, ma è soggetto ai limiti di precisione in virgola mobile. BigInt opera su numeri interi.
Per Number, un divisore pari a 0 o -0, un operando NaN o un dividendo infinito produce NaN. Un dividendo finito con un divisore infinito rimane invariato. Un dividendo negativo può produrre -0, rilevabile con Object.is(result, -0). Per BigInt, un divisore 0n genera un RangeError; questo tipo non ha -0.
% ha la stessa precedenza di * e /, superiore a quella di + e -; gli operatori di questo gruppo si associano da sinistra a destra. Fa parte del linguaggio ECMAScript, non di un’API Web. L’esempio richiede un ambiente che supporti BigInt.
Esempi
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));Risultato
-3 2 1.5 3 true true
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.