Fehler
c0de hat keine Exceptions, keinen try- und keinen catch-Block. Trotzdem verhalten sich Fehler ganz ähnlich wie Exceptions: Eine Funktion, die scheitert, hält an, und ihr Fehler wandert die Aufrufe hinauf, bis ein Aufrufer ihn abfängt. Das Abfangen passiert beim CALL, mit einer Variablen vom Typ ERROR. Fängt ihn niemand ab, stürzt der Prozess ab, und der Auslöserblock zeigt den Fehler.
Was du brauchst
Eine Kreativwelt mit erlaubten Cheats (siehe Tutorials), einen Auslöserblock, einen Schraubenschlüssel, einen Knopf, eine STRING-Variablenkarte mit dem Namen input, eine nicht initialisierte Variablenkarte und für den Exit-Code einen Komparator und eine Redstone-Lampe. Für die Übungen: zwei INTEGER-Variablenkarten mit den Namen total und count.
Das Modell
- Ein ausgelöster Fehler beendet die Funktion. Eine Division durch null, ein fehlender Schlüssel oder ein RAISE beendet die aktuelle Funktion, als hätte sie
RETURNmit diesem Fehler ausgeführt. - Der Aufrufer entscheidet. Hat sein CALL eine ERROR-Variable hinter dem Funktionsnamen (
CALL parseAge problem), kommt der Fehler in diese Variable, und der Aufrufer macht weiter. Sonst wird der Fehler im Aufrufer erneut ausgelöst, der damit auch endet, und so weiter die Aufrufe hinauf. - Die Einstiegsfunktion ist die letzte Station. Ein Fehler, der sie erreicht, lässt den Prozess abstürzen: Exit-Code 15, keine Ergebnisse, und alle Karten, die hineingegangen sind, kommen unverändert heraus.
- Manche Fehler lassen sich nicht abfangen. Fehler im Programm selbst (eine rote Zeile, Codes 100 bis 114) und die Fehler des Cursors (Codes 200 bis 206, z. B. STACK_OVERFLOW, ein fehlender Parameter oder eine unbekannte Funktion) lassen den Prozess sofort abstürzen.
Ein Fehler ist eine vordefinierte Struktur mit vier Elementen:
| Element | Typ | Inhalt |
|---|---|---|
code | INTEGER | 0, wenn es keinen Fehler gab |
message | STRING | der Text des Fehlers |
context | STRING | die Funktion, in der er ausgelöst wurde |
line | INTEGER | die Zeile, in der er ausgelöst wurde |
Die Codes der Sprache liegen unter 1000 und haben Namen, die eingebaute Konstanten sind. Das sind die, die ein CALL abfangen kann:
| Code | Name | Wann |
|---|---|---|
| 300 | UNKNOWN_NAME | ein Name, der nicht im Gültigkeitsbereich ist |
| 301 | UNKNOWN_STRUCT_ENTITY | ein Element, das die Struktur nicht hat |
| 302 | TYPE_MISMATCH | ein Wert vom falschen Typ |
| 303 | DIVISION_BY_ZERO | / oder \ durch 0 |
| 304 | NUMERIC_OVERFLOW | ein INTEGER über 64 Bit hinaus |
| 305 | INDEX_OUT_OF_BOUNDS | eine Position außerhalb eines Arrays oder Strings |
| 306 | UNKNOWN_KEY | ein Schlüssel, den der Hash nicht hat |
| 307 | STRING_TOO_LONG | ein Wert, der länger ist als die Grenze seines STRINGs |
| 308 | INVALID_LOOP_STEP | eine FOR-Schleife mit der Schrittweite 0 |
| 309 | INVALID_ARGUMENT | ein Parameterwert, mit dem eine Funktion nichts anfangen kann |
| 310 – 313 | CHUNK_NOT_LOADED, PERMISSION_DENIED, INVENTORY_FULL, ITEM_MISSING | Fehler von c0de/minecraft |
Deine eigenen Fehler verwenden Codes ab 1000.
In Python sähe das Programm dieser Lektion so aus:
class AgeError(Exception): ...
def parse_age(text: str) -> int:
number = float(text) # ValueError für "abc"
if not number.is_integer():
raise AgeError(1001, "not a whole number: " + text)
age = int(number)
if age < 0 or age > 150:
raise AgeError(1002, "out of range: " + str(age))
return age
def signup(input: str) -> str:
try:
parse_age(input)
return "Welcome!"
except Exception as problem:
return "Error: " + str(problem)Das Programm
PROGRAM signup
NOOP
INCLUDE c0de/math
INCLUDE c0de/strings
CONSTANT AGE_NOT_WHOLE INTEGER 1001
CONSTANT AGE_OUT_OF_RANGE INTEGER 1002
NOOP
FUNCTION parseAge
PARAMETER text STRING
RESULT age INTEGER
BEGIN
VARIABLE number FLOAT
VARIABLE whole BOOLEAN
CALL c0de/strings/VAL
PARAMETER text text ;
RESULT value number
RESULT isInteger whole
IF NOT whole ;
BEGIN
CALL RAISE
PARAMETER code AGE_NOT_WHOLE ;
PARAMETER message "not a whole number: " ⊕ text ;
END IF
CALL c0de/math/FIX
PARAMETER value number ;
RESULT result age
IF age < 0 OR age > 150 ;
BEGIN
CALL RAISE
PARAMETER code AGE_OUT_OF_RANGE ;
PARAMETER message "out of range: " ⊕ age ;
END IF
END FUNCTION
NOOP
FUNCTION signup
PARAMETER input STRING
RESULT message STRING
RESULT age INTEGER
BEGIN
VARIABLE problem ERROR
CALL parseAge problem
PARAMETER text input ;
RESULT age age
IF problem.code = 0 ;
BEGIN
ASSIGN message "Welcome!" ;
RETURN
END IF
ASSIGN message "Error " ⊕ problem.code ⊕ ": " ⊕ problem.message ⊕ " (" ⊕ problem.context ⊕ ", line " ⊕ problem.line ⊕ ")" ;
EXIT 1 ;
END FUNCTIONStarten
Stelle den Auslöserblock auf das Programm signup und die Funktion signup ein. Lege die Karte input und eine nicht initialisierte Karte hinein und stelle einen Komparator auf, der den Auslöserblock ausliest, mit einer Lampe dahinter.
input | message | age | Exit-Code |
|---|---|---|---|
"42" | Welcome! | 42 | 0 |
"4.5" | Error 1001: not a whole number: 4.5 (parseAge, line 19) | 0 | 1 |
"200" | Error 1002: out of range: 200 (parseAge, line 28) | 200 | 1 |
"abc" | Error 309: Not a number: abc (c0de/strings/VAL, line 13) | 0 | 1 |
Bei Exit-Code 1 gibt der Komparator ein Signal der Stärke 1 aus, und die Lampe leuchtet, bis der nächste Prozess startet.
Stelle den Auslöserblock jetzt auf die Funktion parseAge ein und benenne die Karte input in text um, mit dem Wert "200". Niemand fängt den Fehler ab: Der Prozess stürzt mit Exit-Code 15 ab, der Auslöserblock spielt einen tiefen Ton, und sein Dialog zeigt den Code 1002, die Meldung out of range: 200, den Kontext parseAge und die Zeile 28. Die Karte text und die nicht initialisierte kommen unverändert heraus.
So funktioniert es
- Eigene Fehler mit RAISE.
CALL RAISEmit einemcodeab 1000 und einermessagegibt einen Fehler an seinen AufruferparseAge. Dieser CALL hat keine ERROR-Variable, also wird der Fehler inparseAgeausgelöst, das sofort endet. RAISE fülltcontextundlinemit der Funktion und der Zeile des CALL. Ein Code unter 1000 löst stattdessen INVALID_ARGUMENT aus. - Konstanten für die Codes. Die globalen Konstanten
AGE_NOT_WHOLEundAGE_OUT_OF_RANGEgeben den Codes Namen, wie die eingebauten Namen der Fehler der Sprache. Ein Aufrufer kannproblem.code = AGE_OUT_OF_RANGE ;vergleichen. - Fehler von Bibliotheksfunktionen. VAL löst für
"abc"INVALID_ARGUMENT aus.parseAgefängt ihn nicht ab, also wandert er weiter zusignup. Er behält seinencontextund seineline: Sie beschreiben immer, wo der Fehler zuerst aufgetreten ist, hier die Bibliotheksfunktionc0de/strings/VAL, aufgerufen in Zeile 13. - Abfangen.
CALL parseAge problemlegt den Fehler inproblem. Die Variable bekommt den Fehler jedes Aufrufs, mit Code 0, wenn es keinen gab, also istIF problem.code = 0 ;die Erfolgsprüfung. - Ergebnisse überleben. Für
"200"istage200, obwohlparseAgegescheitert ist: Der Aufrufer bekommt die Werte, die die Ergebnisse hatten, als die Funktion anhielt. Prüfe den Fehler, bevor du sie verwendest. - Exit-Codes für Redstone.
EXIT 1 ;beendet den Prozess mit Exit-Code 1. Anders als bei einem Absturz werden die Ergebnisse wie gewohnt ins Ausgabeinventar geschrieben. EXIT nimmt 0 bis 15; 15 ist der Code eines Absturzes.
Unterschiede, über die du stolpern wirst
- Es gibt keinen
try-Block. Um einen Fehler abzufangen, muss der Code, der scheitern kann, in einer eigenen Funktion stehen, die mit einer ERROR-Variablen aufgerufen wird. - Ein CALL ohne ERROR-Variable reicht jeden Fehler weiter. Eine vergessene Variable, und der ganze Prozess stürzt ab.
- Fehler haben keine Typen. Unterscheide sie am
code, nicht an einer Klasse. - Ergebnisse werden auch zugewiesen, wenn die Funktion gescheitert ist. Vertraue ihnen nicht, bevor du
codegeprüft hast. - RAISE füllt
contextundlineaus; eine ERROR-Variable, die du selbst füllst und mitRETURN problemzurückgibst, lässt sie leer, wenn du sie nicht setzt. - Syntaxfehler, STACK_OVERFLOW, ein fehlender Parameter und die anderen Fehler mit Codes unter 300 lassen sich nicht abfangen.
- Ein Absturz verliert alle Ergebnisse. Wenn Redstone auf ein behandeltes Problem reagieren soll, verwende EXIT mit einem Code von 1 bis 14.
Probier es selbst
- Ersetze das RAISE der Bereichsprüfung in
parseAgedurch eine ERROR-Variable undRETURN. Wie sieht die Meldung für"200"jetzt aus?
Lösung
PROGRAM signup
NOOP
INCLUDE c0de/math
INCLUDE c0de/strings
CONSTANT AGE_NOT_WHOLE INTEGER 1001
CONSTANT AGE_OUT_OF_RANGE INTEGER 1002
NOOP
FUNCTION parseAge
PARAMETER text STRING
RESULT age INTEGER
BEGIN
VARIABLE number FLOAT
VARIABLE whole BOOLEAN
CALL c0de/strings/VAL
PARAMETER text text ;
RESULT value number
RESULT isInteger whole
IF NOT whole ;
BEGIN
CALL RAISE
PARAMETER code AGE_NOT_WHOLE ;
PARAMETER message "not a whole number: " ⊕ text ;
END IF
CALL c0de/math/FIX
PARAMETER value number ;
RESULT result age
IF age < 0 OR age > 150 ;
BEGIN
VARIABLE problem ERROR
ASSIGN problem.code AGE_OUT_OF_RANGE ;
ASSIGN problem.message "out of range: " ⊕ age ;
RETURN problem
END IF
END FUNCTION
NOOP
FUNCTION signup
PARAMETER input STRING
RESULT message STRING
RESULT age INTEGER
BEGIN
VARIABLE problem ERROR
CALL parseAge problem
PARAMETER text input ;
RESULT age age
IF problem.code = 0 ;
BEGIN
ASSIGN message "Welcome!" ;
RETURN
END IF
ASSIGN message "Error " ⊕ problem.code ⊕ ": " ⊕ problem.message ⊕ " (" ⊕ problem.context ⊕ ", line " ⊕ problem.line ⊕ ")" ;
EXIT 1 ;
END FUNCTIONDie Meldung ist Error 1002: out of range: 200 (, line 0): Ein Fehler, den du selbst baust, hat einen leeren context und die Zeile 0, wenn du sie nicht zuweist. RAISE füllt sie für dich aus.
- Schreibe eine Funktion
reportmit den Parameterntotalundcount, die den Textaverage: …zurückgibt oderno values yet, wenncount0 ist. Lass die Division scheitern und fange DIVISION_BY_ZERO ab.
Lösung
PROGRAM averages
NOOP
NOOP
FUNCTION average
PARAMETER total INTEGER
PARAMETER count INTEGER
RESULT result FLOAT
BEGIN
ASSIGN result total / count ;
END FUNCTION
NOOP
FUNCTION report
PARAMETER total INTEGER
PARAMETER count INTEGER
RESULT text STRING
BEGIN
VARIABLE problem ERROR
VARIABLE mean FLOAT
CALL average problem
PARAMETER total total ;
PARAMETER count count ;
RESULT result mean
IF problem.code = DIVISION_BY_ZERO ;
BEGIN
ASSIGN text "no values yet" ;
END
ELSE
BEGIN
ASSIGN text "average: " ⊕ mean ;
END IF
END FUNCTIONMit total = 7 und count = 2 ist der Text average: 3.5; mit count = 0 ist er no values yet. Die Division braucht eine eigene Funktion, weil nur ein CALL einen Fehler abfangen kann.
Mehr dazu
- Die Sprache: Fehler, Eigene Fehler, RETURN und EXIT
- Programme ausführen: Exit-Codes und Abstürze
- Handbuch Funktionen: RAISE
- Handbuch Daten: TYPE_ERROR
- Handbuch Anweisungen: RETURN, CALL und EXIT