Circonferenza e area di un cerchio

Entrambi i valori vengono restituiti arrotondati half-up a un numero configurabile di decimali, insieme alla costante π utilizzata, così la risposta è deterministica e confrontabile byte per byte. È la classica coppia della geometria calcolata in una sola chiamata deterministica invece di due ricerche separate, senza ambiguità di unità: nell'unità in cui è il raggio è la circonferenza, e l'area è in quell'unità al quadrato.

Due formule, un solo raggio

Un cerchio è completamente descritto da un'unica misura. Una volta noto il raggio, tutto il resto segue: la circonferenza — la lunghezza del bordo — è 2·π·r, e l'area — la superficie racchiusa da quel bordo — è π·r². Nessun input di diametro, nessuna conversione di unità, nessuno stato nascosto: lo stesso raggio produce sempre la stessa circonferenza e la stessa area, che è esattamente ciò che ci si aspetta da una primitiva su cui altri sistemi si costruiscono.

Se dispone solo del diametro, lo divida prima per due; se ha solo la circonferenza, la divida per 2π. Mantenere il contratto con un solo campo obbligatorio permette a qualsiasi client — uno script di foglio di calcolo, un microcontrollore, un modulo web — di soddisfarlo senza casi particolari.

Come vengono prodotti i numeri

Il determinismo qui è una caratteristica, non un caso. Il calcolo usa il valore completo di π in doppia precisione (3.141592653589793), valuta 2·π·r e π·r², e poi arrotonda ogni risultato half-up al numero di decimali richiesto. La validazione è volutamente rigorosa.

Le richieste rifiutate non vengono mai addebitate: è il codice dell'errore a decidere se una chiamata costa qualcosa, e gli errori di input sono sempre responsabilità del chiamante. Se un raggio è così grande che l'area supera la doppia precisione, anche questo viene segnalato come errore di input invece di restituire Infinity in silenzio, così ogni risposta ricevuta è sempre un numero reale e utilizzabile.

Dove compare la coppia nella pratica

La coppia circonferenza–area compare ovunque qualcosa di rotondo venga progettato, preventivato o fabbricato. Un preventivo di recinzione ha bisogno della circonferenza di un recinto circolare per totalizzare i metri di filo, e dell'area per stimare la semente; uno stampatore di scatole per pizza ha bisogno dell'area della base e della circonferenza che determina la striscia di cartone che la avvolge; un ingegnere di ruote converte il raggio in circonferenza per sapere quanto avanza il veicolo a ogni giro, e in area per i calcoli di carico e pressione.

Poiché la capacità è una funzione pura, funziona molto bene anche come primitiva didattica e di test: gli studenti possono verificare i compiti con essa, e gli ingegneri possono usarla come un passo a risposta nota all'interno di una pipeline più grande. Per cerchi definiti da qualcosa di diverso dal raggio, o per altre figure, il catalogo offre capacità complementari; questa resta volutamente a scopo unico.