rad2deg()

Die PHP-Funktion rad2deg() wandelt einen in Radiant gemessenen Winkel in den entsprechenden Winkel in Grad um. Sie ist das genaue Gegenstück zu deg2rad() und praktisch, wenn eine Mathematikfunktion ein Ergebnis in Radiant liefert, aber ein menschenlesbarer Wert in Grad benötigt wird.

Was sind Radiant und Grad?

Sowohl Radiant als auch Grad messen Winkel – es handelt sich lediglich um zwei verschiedene Einheiten, ähnlich wie Meter und Fuß.

• Ein vollständiger Kreis entspricht 360 Grad oder 2π Radiant.
• Damit entspricht 1 Radiant 180/π Grad, also etwa 57,29578 Grad.

PHPs eingebaute trigonometrische Funktionen (sin(), cos(), atan(), …) arbeiten alle mit Radiant, daher ist rad2deg() die Brücke, die diese Ergebnisse wieder in Grad umwandelt, die die meisten Menschen verstehen.

Syntax

rad2deg(float $num): float

• $num — der Winkel in Radiant, den Sie umrechnen möchten.
• Rückgabewert — derselbe Winkel in Grad, als float.

Verwendung der Funktion rad2deg()

Übergeben Sie den Radiant-Wert, und rad2deg() gibt den Winkel in Grad zurück:

Hier werden 1,047 Radiant (nahe π/3) in ungefähr 60 Grad umgerechnet.

Häufige Referenzwerte

Mit PHPs M_PI-Konstante (derselbe Wert, den pi() zurückgibt) lassen sich die bekannten Winkel folgendermaßen umrechnen:

<?php
echo rad2deg(M_PI);       // 180
echo "\n";
echo rad2deg(M_PI / 2);   // 90
echo "\n";
echo rad2deg(M_PI / 4);   // 45
echo "\n";
echo rad2deg(2 * M_PI);   // 360
?>

rad2deg() vs. deg2rad()

Die beiden Funktionen sind Spiegelbilder voneinander – eine Umrechnung in die eine Richtung und zurück liefert den ursprünglichen Wert:

<?php
$degrees = 90;

$radians = deg2rad($degrees);   // 1.5707963267949
$back     = rad2deg($radians);  // 90

echo $back;                     // 90
?>

Verwenden Sie deg2rad() vor dem Aufruf einer trigonometrischen Funktion und rad2deg() danach.

Praktisches Beispiel: Winkel aus cos() auslesen

Inverse trigonometrische Funktionen geben Radiant zurück. Wandeln Sie das Ergebnis mit rad2deg() in einen lesbaren Winkel um und verwenden Sie round(), um den langen Float zu kürzen:

<?php
// acos() returns the angle (in radians) whose cosine is 0.5
$radians = acos(0.5);

$degrees = rad2deg($radians);

echo round($degrees, 2);   // 60
?>

Wichtige Hinweise

• rad2deg() gibt immer einen float zurück, auch bei ganzzahligen Ergebnissen wie 180. Verwenden Sie round() oder number_format(), wenn Sie einen ordentlichen Anzeigewert benötigen.
• Die Funktion ändert nur die Einheit, nicht den Winkel selbst – rad2deg(M_PI) und M_PI beschreiben dieselbe Richtung.
• Das Übergeben eines nicht-numerischen Strings löst in PHP 8+ einen TypeError aus; stellen Sie sicher, dass das Argument numerisch ist.

Fazit

rad2deg() ist ein kleiner, aber wichtiger Helfer für jeden PHP-Code, der mit Winkeln arbeitet. Kombinieren Sie sie mit deg2rad(), den trigonometrischen Funktionen und pi(), um bequem zwischen den Radiant-Werten des Mathematik-Engines und den Grad zu wechseln, die Menschen verstehen.

Übung