Kreisumfang & Kreisfläche berechnen

Beide Werte werden half-up auf eine konfigurierbare Anzahl von Dezimalstellen gerundet zurückgegeben, zusammen mit der verwendeten Konstante π, sodass die Antwort deterministisch ist und Byte für Byte verglichen werden kann. Es ist das klassische Paar der Geometrie, berechnet in einem einzigen deterministischen Aufruf statt in zwei separaten Abfragen, ohne Einheitenmehrdeutigkeit: In der Einheit des Radius liegt der Umfang, und die Fläche liegt in dieser Einheit zum Quadrat.

Zwei Formeln, ein einziger Radius

Ein Kreis ist durch eine einzige Messung vollständig beschrieben. Sobald der Radius bekannt ist, folgt alles Weitere: der Umfang — die Länge des Randes — beträgt 2·π·r, und die Fläche — die von diesem Rand eingeschlossene Oberfläche — beträgt π·r². Keine Durchmessereingabe, keine Einheitenumrechnung, kein verborgener Zustand: Derselbe Radius ergibt immer denselben Umfang und dieselbe Fläche — genau das, was man von einer Primitive erwartet, auf der andere Systeme aufbauen.

Wenn Sie nur den Durchmesser haben, teilen Sie ihn zuerst durch zwei; wenn Sie nur den Umfang haben, teilen Sie ihn durch 2π. Ein Vertrag mit nur einem Pflichtfeld ermöglicht es jedem Client — einem Tabellenskript, einem Mikrocontroller, einem Webformular —, ihn ohne Sonderfälle zu erfüllen.

Wie die Zahlen erzeugt werden

Determinismus ist hier ein Merkmal, kein Zufall. Die Berechnung verwendet den vollen Wert von π in doppelter Genauigkeit (3.141592653589793), wertet 2·π·r und π·r² aus und rundet anschließend jedes Ergebnis half-up auf die gewünschte Anzahl von Dezimalstellen. Die Validierung ist absichtlich streng.

Abgelehnte Anfragen werden niemals berechnet: Der Fehlercode entscheidet, ob ein Aufruf etwas kostet, und Eingabefehler liegen immer in der Verantwortung des Aufrufers. Ist ein Radius so groß, dass die Fläche die doppelte Genauigkeit übersteigt, wird auch dies als Eingabefehler gemeldet, statt stillschweigend Infinity zurückzugeben — jede erhaltene Antwort ist also immer eine reale, verwendbare Zahl.

Wo das Paar in der Praxis auftaucht

Das Paar Umfang–Fläche taucht überall dort auf, wo etwas Rundes entworfen, kalkuliert oder gefertigt wird. Ein Zaunangebot benötigt den Umfang einer kreisförmigen Koppel, um die Meter Draht zu summieren, und die Fläche, um das Saatgut zu schätzen; ein Pizzakartondrucker benötigt die Bodenfläche und den Umfang, der den Kartonstreifen bestimmt, der sie umschließt; ein Radingenieur rechnet den Radius in den Umfang um, um zu wissen, wie weit das Fahrzeug pro Umdrehung fährt, und in die Fläche für Last- und Druckberechnungen.

Da die Fähigkeit eine reine Funktion ist, eignet sie sich auch hervorragend als Lehr- und Testprimitive: Studierende können Hausaufgaben damit prüfen, und Ingenieure können sie als Schritt mit bekannter Antwort in einer größeren Pipeline verwenden. Für Kreise, die anders als über den Radius definiert sind, oder für andere Formen hält der Katalog ergänzende Fähigkeiten bereit; diese bleibt bewusst einzweckig.