CKTIS / JavaScript
Math.hypot: euklidische Länge
Math.hypot wandelt beliebig viele Komponenten in Number um und berechnet stabil die Quadratwurzel ihrer Quadratsumme.
Version: ECMAScript 2015 onward; example target: Node.js 24.22.2
Syntax
Math.hypot(...values)Math.hypot(...values) liefert √(x₁² + x₂² + …) als nichtnegatives Number. Ohne Argumente ist es +0, Vorzeichen ändern die Länge nicht. Skalierung vermeidet vorzeitigen Über- und Unterlauf besser als Math.sqrt(x*x + y*y).
Jedes Argument durchläuft ToNumber der Reihe nach. Symbol oder BigInt löst TypeError aus, selbst neben Unendlichkeit. Nach erfolgreicher Umwandlung ergibt ±Infinity stets Infinity, auch neben NaN; ohne Unendlichkeit ergibt jedes NaN NaN. Numerische Zeichenketten werden umgewandelt, Objekte können Code ausführen.
Kein Konstruktor, seit ECMAScript 2015 Standard. Für Vektorlänge oder Math.hypot(x2-x1, y2-y1) in beliebig vielen Dimensionen. Das Number-Ergebnis bleibt den IEEE-754-Präzisionsgrenzen unterworfen.
Beispiele
console.log(Math.hypot(3, 4), Math.hypot());
console.log(Object.is(Math.hypot(-0), 0));
const stable = Math.hypot(3e200, 4e200);
const naive = Math.sqrt((3e200) ** 2 + (4e200) ** 2);
console.log(stable, Number.isFinite(stable), naive);
console.log(Math.hypot(Infinity, NaN), Number.isNaN(Math.hypot(NaN, 1)));
try { Math.hypot(Infinity, 1n); } catch (error) { console.log(error instanceof TypeError); }Ergebnis
5 0 true 4.9999999999999995e+200 true Infinity Infinity true true