CKTIS / JavaScript
Operator reszty z dzielenia (%)
Operator % oblicza resztę z dzielenia dla Number lub BigInt. Wynik niezerowy ma znak dzielnej, więc dla liczb ujemnych nie jest to to samo co nieujemne modulo. Typy operandów oraz dzielenie przez zero wymagają uwagi.
Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Składnia
dividend % divisorW wyrażeniu dividend % divisor lewy operand jest dzielną, a prawy dzielnikiem. Dla skończonych wartości i niezerowego dzielnika reszta odpowiada odjęciu od dzielnej iloczynu dzielnika i ilorazu obciętego w kierunku zera. Niezerowy wynik ma znak dzielnej: -13 % 5 daje -3, a 13 % -5 daje 3. % nie oznacza procentu.
Reszta nie jest tym samym co nieujemne modulo. Dla całkowitych wartości Number w bezpiecznym zakresie i dodatniego dzielnika można normalizować wynik wyrażeniem ((dividend % divisor) + divisor) % divisor; uwzględnij również bezpieczny zakres sumy pośredniej. Dla -13 i 5 daje ono 2.
Operandy są konwertowane do wartości numerycznych; po konwersji oba muszą być typu Number albo oba typu BigInt. Mieszanie tych typów powoduje TypeError. Number dopuszcza ułamki, np. 5.5 % 2 daje 1.5, ale podlega ograniczeniom precyzji zmiennoprzecinkowej. BigInt działa na liczbach całkowitych.
Dla Number dzielnik 0 lub -0, operand NaN albo nieskończona dzielna daje NaN. Skończona dzielna przy nieskończonym dzielniku pozostaje bez zmian. Ujemna dzielna może dać -0, co wykrywa Object.is(result, -0). Dla BigInt dzielnik 0n powoduje RangeError; ten typ nie ma -0.
% ma ten sam priorytet co * i /, wyższy niż + i -; operatory tej grupy wiążą od lewej. Jest częścią języka ECMAScript, nie interfejsem Web API. Przykład wymaga środowiska obsługującego BigInt.
Przykłady
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));Wynik
-3 2 1.5 3 true true
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.