Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

Rest (%)

Baseline
Weitgehend verfügbar

Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Juli 2015 browserübergreifend verfügbar.

Der Restoperator (%) gibt den Rest zurück, der übrig bleibt, wenn ein Operand durch einen zweiten Operanden geteilt wird. Das Ergebnis hat stets das Vorzeichen des Dividenden.

Probieren Sie es aus

console.log(13 % 5);
// Expected output: 3

console.log(-13 % 5);
// Expected output: -3

console.log(4 % 2);
// Expected output: 0

console.log(-4 % 2);
// Expected output: -0

Syntax

js
x % y

Beschreibung

Der %-Operator ist für zwei Arten von Operanden überladen: Number und BigInt. Zunächst wandelt er beide Operanden in numerische Werte um und prüft deren Typen. Sind beide Operanden danach BigInts, berechnet er den BigInt-Rest; andernfalls berechnet er den Number-Rest. Ein TypeError wird ausgelöst, wenn ein Operand zu einem BigInt und der andere zu einer Number wird.

Bei der Operation n % d heißt n Dividend und d Divisor. Die Operation gibt NaN zurück, wenn einer der Operanden NaN ist, n ±Infinity ist oder d ±0 ist. Ist dagegen d ±Infinity oder n ±0, wird der Dividend n zurückgegeben.

Wenn beide Operanden ungleich null und endlich sind, wird der Rest r als r := n - d * q berechnet. Dabei ist q die ganze Zahl, bei der r dasselbe Vorzeichen wie der Dividend n hat und gleichzeitig möglichst nahe bei 0 liegt.

Beachten Sie: In den meisten Sprachen ist '%' ein Restoperator, in einigen (z. B. Python und Perl) jedoch ein Modulo-Operator. Modulo ist definiert als k := n - d * q, wobei q die ganze Zahl ist, bei der k dasselbe Vorzeichen wie der Divisor d hat und gleichzeitig möglichst nahe bei 0 liegt. Haben beide Werte dasselbe Vorzeichen, sind die Ergebnisse gleich. Bei unterschiedlichen Vorzeichen hat das Modulo-Ergebnis dagegen immer das Vorzeichen des Divisors, während der Rest das Vorzeichen des Dividenden hat. Dadurch können sich die Ergebnisse um einmal d unterscheiden. Um in JavaScript statt n % d ein Modulo-Ergebnis zu erhalten, verwenden Sie ((n % d) + d) % d. In JavaScript wird die Modulo-Operation (für die es keinen eigenen Operator gibt) verwendet, um den zweiten Operanden bitweiser Verschiebungsoperatoren (<<, >> usw.) so zu normalisieren, dass der Versatz stets ein positiver Wert ist.

Bei der BigInt-Restberechnung wird ein RangeError ausgelöst, wenn der Divisor y 0n ist. Der Grund dafür ist, dass die Restberechnung mit Number bei einer Division durch null NaN zurückgibt, BigInt jedoch kein NaN kennt.

Beispiele

Rest bei positivem Dividenden

js
13 % 5; // 3
1 % -2; // 1
1 % 2; // 1
2 % 3; // 2
5.5 % 2; // 1.5

3n % 2n; // 1n

Rest bei negativem Dividenden

js
-13 % 5; // -3
-1 % 2; // -1
-4 % 2; // -0

-3n % 2n; // -1n

Rest bei NaN

js
NaN % 2; // NaN

Rest bei Infinity

js
Infinity % 2; // NaN
Infinity % 0; // NaN
Infinity % Infinity; // NaN
2 % Infinity; // 2
0 % Infinity; // 0

Spezifikationen

Spezifikation
ECMAScript® 2027 Language Specification
# sec-multiplicative-operators

Browser-Kompatibilität

Siehe auch