rad2deg()

La funzione PHP rad2deg() converte un angolo misurato in radianti nell'angolo equivalente in gradi. È l'inverso esatto di deg2rad(), ed è molto utile ogni volta che una funzione matematica restituisce un risultato in radianti ma occorre un valore in gradi più comprensibile.

Cosa Sono i Radianti e i Gradi?

Sia i radianti che i gradi misurano gli angoli — sono semplicemente due unità di misura diverse, come metri e piedi.

• Un cerchio completo corrisponde a 360 gradi, o 2π radianti.
• Questo significa che 1 radiante equivale a 180/π gradi, ovvero circa 57.29578 gradi.

Le funzioni trigonometriche integrate di PHP (sin(), cos(), atan(), …) lavorano tutte in radianti, quindi rad2deg() è il ponte che trasforma quei risultati in gradi comprensibili dalla maggior parte delle persone.

Sintassi

rad2deg(float $num): float

• $num — l'angolo in radianti da convertire.
• Valore restituito — lo stesso angolo espresso in gradi, come float.

Come Usare la Funzione rad2deg()

Passa il valore in radianti e rad2deg() restituisce l'angolo in gradi:

Qui 1.047 radianti (vicino a π/3) vengono convertiti in circa 60 gradi.

Valori di Riferimento Comuni

Utilizzando la costante PHP M_PI (lo stesso valore restituito da pi()), gli angoli più noti si convertono in questo modo:

<?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()

Le due funzioni sono l'immagine speculare l'una dell'altra, quindi convertire in un senso e poi nell'altro restituisce il valore originale:

<?php
$degrees = 90;

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

echo $back;                     // 90
?>

Usa deg2rad() prima di chiamare una funzione trigonometrica, e rad2deg() dopo.

Esempio Pratico: Leggere un Angolo da cos()

Le funzioni trigonometriche inverse restituiscono radianti. Converti il risultato con rad2deg() per ottenere un angolo leggibile, e usa round() per arrotondare il float lungo:

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

$degrees = rad2deg($radians);

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

Cose da Tenere a Mente

• rad2deg() restituisce sempre un float, anche per risultati interi come 180. Usa round() o number_format() quando hai bisogno di un valore visualizzato in modo ordinato.
• Cambia solo l'unità di misura, non l'angolo stesso — rad2deg(M_PI) e M_PI descrivono la stessa direzione.
• Passare una stringa non numerica genera un TypeError in PHP 8+; assicurati che l'argomento sia numerico.

Conclusione

rad2deg() è un piccolo ma essenziale strumento per qualsiasi codice PHP che lavora con gli angoli. Abbinala a deg2rad(), alle funzioni trigonometriche e a pi() per muoverti agevolmente tra i radianti usati dal motore matematico e i gradi compresi dalle persone.

Pratica