ViewController

String-Konstante mit Temperatur-Einheit °C (Grad Celsius), zum Anhängen an Anzeige-Texte.

Formatierer-Objekt für den Ergebniswert (Liter kaltes Wasser), für Darstellung mit immer genau einer Nachkommastelle. Wird mit einem Closure initialisiert.

UI-Element zum Einstellen der Heißwassertemperatur; Bereich: 0°C bis 100°C, jeweils einschließlich.

UI-Element zum Einstellen der Kaltwassertemperatur; Bereich: 0°C bis 100°C, jeweils einschließlich.

UI-Element zum Einstellen der Zieltemperatur (gewünschte Misch-Temperatur); Bereich: 0°C bis 100°C, jeweils einschließlich.

UI-Element zur Anzeige der mit zugehörigem Slider aktuell eingestellten Heißwassertemperatur.

UI-Element zur Anzeige der mit zugehörigem Slider aktuell eingestellten Kaltwassertemperatur.

UI-Element zur Anzeige der mit zugehörigem Slider aktuell eingestellten Zieltemperatur (Mischtemperatur).

Textfeld zur Eingabe der Heißwassermenge; wird in Methode viewDidLoad() so konfiguriert, dass nur Ganzzahlwerte in dieses Feld eingegeben werden können. Die in diesem Feld eingegebene Wassermenge kann mit der Methode getHeisswasserLiter() ausgelesen werden.

Event-Handler-Methode für Änderung Kaltwasser-Temperatur mit Slider-Element.

Event-Handler-Methode für Änderung Heißwasser-Temperatur mit Slider-Element.

Event-Handler-Methode für Änderung Ziel-Temperatur (Misch-Temperatur) mit Slider-Element.

Event-Handler-Methode für Button Catch 1, führt Formel-Berechnung aus.

Event-Handler-Methode für Button Catch 2, führt Formel-Berechnung aus.

Event-Handler-Methode für Button Catch 3, führt Formel-Berechnung aus.

Event-Handler-Methode für Button Try? (optional try), führt Formel-Berechnung aus.

Event-Handler-Methode für Button Try! (forced try), führt Formel-Berechnung aus.

Event-Handler-Methode für Button Defer, führt Formel-Berechnung durch. Unabhängig vom Erfolg der Berechnung (d.h. auch dann wenn ein Fehler geworfen wird) werden die drei Slider auf zulässige Start-Werte gesetzt.

Event-Handler-Methode für Button OOP, führt Formel-Berechnung aus.

Event-Handler-Methode für Button Guard, führt Formel-Berechnung aus.

Event-Handler-Methode für Button Assert, führt Formel-Berechnung durch. Wenn eine der drei Temperatur-Werte außerhalb des zulässigen Bereichs von echt-größer 0°C und echt-kleiner 100°C liegt, dann wird die App abgebrochen (aber nur wenn für Konfiguration DEBUG gebaut).

Bitte in der Doku zu Methode berechnungDurchfuehren_Assert() nachlesen wie das Projekt für einen DEBUG-Build zu konfigurieren ist.

Event-Handler-Methode für Button FatalError, führt Formel-Berechnung durch. Wenn eine der drei Temperatur-Werte außerhalb des zulässigen Bereichs von echt-größer 0°C und echt-kleiner 100°C liegt, dann wird die App abgebrochen, und zwar unabhängig von der Build-Konfiguration.

Methode sorgt dafür, dass zum Start die drei Textfelder den aktuellen Wert der jeweiligen Slider anzeigen. Außerdem wird das Textfeld für die Eingabe der Heißwassermenge so konfiguriert, dass nur zulässige Ganzzahlen eingegeben werden können.

Funktion zur Anzeige eines Textes mit einem modalen Dialog (ohne Titel).

Methode zum Auslesen der Kaltwassermenge in Liter, die im vom Outlet textFieldMengeHeissesWasser repräsentierten Textfeld gerade eingegeben ist. Dieses Textfeld ist so konfiguriert, dass nur positive Ganzzahlwerte (Milli-Liter) eingegeben werden können.

Methode zur Formatierung der Ergebnismenge (Liter kaltes Wasser) in einen Anzeige-String mit immer genau einer Nachkommastelle.

Methode zur Durchführung der eigentlichen Berechnung.

Catch 1: Nur Default-Catch.

Methode zur Durchführung der eigentlichen Berechnung.

Catch 2: Mehrere Catch-Blöcke für verschiedene Fehler-Typen.

Methode zur Durchführung der eigentlichen Berechnung.

Catch 3: Ein Catch-Block mit Switch-Case zur Unterscheidung der verschiedenen Temperatur-Fehler.

Methode zur Durchführung der eigentlichen Berechnung.

Fehlerbehandlung mit sog. Optional Try (try?).

Methode zur Durchführung der eigentlichen Berechnung.

Fehlerbehandlung mit sog. Forced try (try!).

Durchführung der Berechnung mit einem defer-Block, der unmittelbar vor Verlassen des umgebenden Blocks (hier: Rumpf der Methode) ausgeführt wird, egal wie der Block beendet wurde. Für die Fehlerbehandlung kann defer deshalb in etwa die Funktion des aus dem Exception-Handling bei anderen Programmiersprachen bekannten finally-Blocks übernehmen. In der Methode wird defer dafür verwendet, die Eingabewerte der drei Slider auf (zulässige) Start-Werte zu setzen, egal ob die Berechnung durchgeführt werden konnte oder ein Fehler an den Aufrufer hochgereicht wird.

Diese Methode macht dasselbe wie die Methode berechnungDurchfuehren, verwendet statt der Funktion berechneWassermenge aber die Klasse MischTemperaturRechner.

Wie Methode berechnungDurchfuehren_OOP(), nur dass jetzt eine Instanz der Klasse MischTemperaturRechnerMitGuard verwendet wird, in der die Methode berecheKaltwassermenge() so überschrieben ist, dass die Fehler unter Verwendung des Schlüsselworts guardausgelöst werden.

Die Variante der Fehlerbehandlung verwendet zu Beginn einige assert-Statements, um Bedingungen (bool'scher Ausdrücke) zu definieren, die erfüllt sein müssen; ist eine dieser Bedingungen nicht erfällt, dann wird eine für die Konfiguration DEBUG gebaute App abgebrochen. Die im assert-Statement als zweiter Parameter übergebene Fehlerbeschreibung wird dabei auf der XCode-Konsole ausgegeben. Wenn die App für die Konfiguration RELEASE gebaut wurde, dann wird ein assert mit nicht erfüllter Bedingung einfach ignoriert.

Konsole sichtbar machen:

Die XCode-Konsole kann ggf. mit einer der folgenden beiden Möglichkeiten eingeblendet werden:

• Menü-Eintrag: View | Debug Area | Activate Console
• Tasten-Kombination: Shift+Cmd+C

Die Konsole sollte rechts unten in XCode erscheinen.

Build-Konfiguration einstellen:

• Im Project Navigation auf den obersten Eintrag klicken (Projekt selbst).
• In Hauptfenster auf Tab Build Settings.
• Mit Suchfunktion nach SWIFT_OPTIMIZATION_LEVEL suchen.
• Wenn als Wert “None [-Onone]“ eingestellt ist, dann wird ein DEBUG-Build erstellt, d.h. die App bricht bei einer nicht erfüllten Assertion ab.
• Für einen anderen Wert (Fast, Single-File Optimization [-O] oder “Fast, Whole Module Optimization [-O -whole-module-optimization]“ wird ein RELEASE-Build erzeugt.
• Über einen App-Store können nur RELEASE-Builds verteilt werden, d.h. das assert- Statement zur Fehlersuche kann nur für Haus-interne Tests verwendet werden.
• Siehe auch diesen Blog-Artikel.

Diese Variante der Fehlerbehandlung verwendet die Funktion fatalError(), um bei einem ungültigen Wert für eine der drei Temperaturen die App abzubrechen (unbhängig von der Build-Konfiguration). Ein fatalError kann nicht abgefangen werden. Die der Funktion fatalError() übergebene Fehlermeldung wird in der XCode-Konsole ausgegeben; siehe Erklärung in Dokumentation zu Methode berechnungDurchfuehren_Assert(), wie diese Konsole eingeblendet werden kann.

Event-Handler-Methode für den in der Methode viewDidLoad() definierten Tap-Recognizer, um das Keyboard wieder verschwinden zu lassen, wenn nach Eingabe in UITextField-Instanz an eine Stelle außerhalb des Keyboards getappt wird. Ruft auch Berechnung auf.

Methode aus Protocol UITextFieldDelegate überschreiben, damit nur Zahlen eingegeben werden können. Siehe auch diese Antwort auf stackoverflow.com. Methode wird für jeden Tastendruck (auch Loeschung) aufgerufen, also sind in replacementString einzelne Zeichen.

Nicht benötigte Methode