Eigene Funktionen
Das Willkommensschild von Oak Hill soll schick aussehen: jeder Text in einem Rahmen aus Sternen. Ein Rahmen braucht mehrere Zeilen Code: die Buchstaben zählen, eine Zeile aus Sternen bauen, drei Zeilen ausgeben. Das alles dreimal zu schreiben wäre lang und langweilig, und jeder Fehler wäre auch dreimal da. Heute schreibst du den Rahmen einmal, als eigene Funktion, und verwendest ihn, so oft du willst.
Neue Wörter
- Funktion: ein benanntes Stück eines Programms, das eine Aufgabe erledigt. Einstiegsfunktionen schreibst du seit deinem ersten Programm; jetzt schreibst du eine, die eine andere Funktion aufruft.
- Aufruf: eine Funktion mit CALL aus einer anderen Funktion heraus ausführen. Wenn sie fertig ist, kommt der Cursor zur Zeile nach dem CALL zurück.
- Standardwert: der Wert, den ein Parameter bekommt, wenn der Aufrufer ihn weglässt.
- RETURN: beendet eine Funktion vorzeitig.
Was du brauchst
- deine Anzeigewand aus 2 × 1 Anzeigeblöcken und den Auslöserblock mit seinem Knopf
- ein neues, leeres Blatt in der c0de-Dimension
- aus dem Kreativinventar: die Blöcke, die du kennst (mit PARAMETER, RESULT, IF und FOR), und den neuen RETURN-Block (für die Aufgaben auch einen CHAR-Typblock)
Die Idee
Denk an ein Kochbuch. Das Rezept für einen Kuchen sagt „Teig zubereiten (siehe Seite 12)“. Seite 12 erklärt den Teig einmal, und jedes Rezept, das einen Teig braucht, verweist darauf. Findest du einen besseren Teig, änderst du eine Seite, und jeder Kuchen wird besser.
Eine Funktion ist so eine Seite. Sie hat einen Namen, sie erledigt eine Aufgabe, und andere Teile des Programms rufen sie auf, wenn sie diese Aufgabe brauchen. Wie ein Rezept, das „Teig für 2 Personen“ sagt, kann ein Aufruf Angaben mitgeben: die Parameter. Und wie der Teig, der zum Kuchen zurückkommt, kann eine Funktion Ergebnisse zurückgeben.
Von außen kennst du das schon: CLS, PRINT und LOCATE sind Funktionen, die c0de mitbringt, und deine Einstiegsfunktionen haben Parameter und Ergebnisse aus Variablenkarten bekommen. Heute schreibst du eine Funktion, die dein eigenes Programm aufruft.
Das Programm
Das Programm frame kommt auf ein neues Blatt. Es hat zwei Funktionen: framed zeichnet einen Rahmen, welcome verwendet ihn dreimal.
PROGRAM frame
NOOP
CONSTANT BASE STRING "Oak Hill"
NOOP
FUNCTION framed
PARAMETER text STRING
PARAMETER row INTEGER 0
PARAMETER column INTEGER 0
RESULT width INTEGER
BEGIN
VARIABLE border STRING
IF text = "" ;
BEGIN
RETURN
END IF
CALL LEN
PARAMETER value text ;
RESULT result width
ASSIGN width width + 4 ;
FOR i INTEGER 1 ; width ;
BEGIN
ASSIGN border border ⊕ "*" ;
END FOR
CALL LOCATE
PARAMETER row row ;
PARAMETER column column ;
CALL PRINT
PARAMETER value border ;
CALL LOCATE
PARAMETER row row + 1 ;
PARAMETER column column ;
CALL PRINT
PARAMETER value "* " ⊕ text ⊕ " *" ;
CALL LOCATE
PARAMETER row row + 2 ;
PARAMETER column column ;
CALL PRINT
PARAMETER value border ;
END FUNCTION
NOOP
FUNCTION welcome
BEGIN
VARIABLE used INTEGER
CALL CLS
CALL framed
PARAMETER text "Welcome" ;
RESULT width used
CALL framed
PARAMETER text BASE ;
PARAMETER column used + 1 ;
CALL framed
PARAMETER text "Mind the creepers!" ;
PARAMETER row 4 ;
END FUNCTION
So baust du es
Das Programm ist lang, aber du kennst fast jede Zeile. Die neuen Teile:
- Zeilen 4 bis 8: FUNCTION
framedbei x=5, dann vier Zeilen bei x=6: PARAMETERtextSTRING, PARAMETERrowINTEGER mit einem LITERAL 0 am Ende, PARAMETERcolumnINTEGER mit einem LITERAL 0 und RESULTwidthINTEGER. - Zeile 11: IF bei x=6 mit einem LABEL
text, einem OPERATOR=, einem LITERAL""(ein leerer Text) und einem OPERATOR;. - Zeile 13: ein RETURN-Block bei x=7, allein.
- Zeilen 15 bis 17: ein CALL-Block bei x=6 mit einem LABEL
LEN, dann PARAMETERvaluemit LABELtextund;und RESULT mit den LABELsresultundwidth, beide bei x=7. - Zeile 39: eine NOOP-Zeile. Jede FUNCTION braucht direkt über sich eine.
- Zeilen 44 bis 46: ein CALL-Block bei x=6 mit einem LABEL
framed, dann bei x=7 ein PARAMETER-Block, ein LABELtext, ein LITERAL"Welcome"und ein OPERATOR;und ein RESULT-Block mit den LABELswidthundused. - Zeile 49: ein PARAMETER-Block bei x=7, ein LABEL
column, ein LABELused, ein OPERATOR+, ein LITERAL 1 und ein OPERATOR;.
Starten
Binde die Anzeigewand an das Programm frame und die Funktion welcome und stelle den Auslöserblock genauso ein. Drück den Knopf. Die Rahmen erscheinen nacheinander, und nach ein paar Sekunden zeigt die Wand:
*********** ************
* Welcome * * Oak Hill *
*********** ************
**********************
* Mind the creepers! *
**********************
So funktioniert es
Die Funktion framed:
- Ihre PARAMETER-Zeilen sagen, was ein Aufrufer ihr geben kann: einen
textund eine Zeilerowund Spaltecolumn, wo der Rahmen beginnt.rowundcolumnhaben den Standardwert 0. Ein Aufrufer, der sie weglässt, bekommt die linke obere Ecke. - Ihre RESULT-Zeile sagt, was sie zurückgibt: die Breite
widthdes Rahmens. Ein Ergebnis beginnt mit dem Standardwert seines Typs, hier 0. IF text = "" ;mitRETURNdarin: Ein leerer Text bekommt keinen Rahmen. RETURN beendet die Funktion sofort, und der Cursor geht zurück zum Aufrufer.CALL LENzählt die Buchstaben des Texts. LEN ist eine Funktion, die c0de mitbringt, und du rufst sie auf wie deine eigene:PARAMETER value text ;gibt ihr den Text,RESULT result widthlegt ihr Ergebnisresultin deine Variablewidth. „Welcome“ hat 7 Buchstaben.- Der Rahmen ist um 4 breiter als der Text: ein Stern und ein Leerzeichen auf jeder Seite. Die FOR-Schleife baut in
bordereine Zeile mit so vielen Sternen. - Dreimal LOCATE und PRINT: die obere Zeile, der Text zwischen
*und*und die untere Zeile, jede eine Zeile tiefer (row + 1,row + 2).
Die Funktion welcome ruft sie dreimal auf:
CALL framedmitPARAMETER text "Welcome" ;und sonst nichts:rowundcolumnsind 0.RESULT width usedspeichert das Ergebniswidthvonframedin der Variablenusedvonwelcome: 11.- Der zweite Aufruf rahmt
BASEbeicolumn used + 1ein, also in Spalte 12, neben dem ersten Rahmen. - Der dritte Aufruf rahmt „Mind the creepers!“ in Zeile 4 ein. Sein Ergebnis wird nicht gebraucht, also hat er keine RESULT-Zeile, und das Ergebnis wird verworfen.
Jeder Aufruf bekommt eigene, frische Variablen: border beginnt jedes Mal leer. Und die Parameter sind Kopien, also kann framed die Variablen von welcome nicht aus Versehen ändern.
Eine Funktion kann nur Funktionen aufrufen, die auf dem Blatt über ihr liegen. Darum kommt framed zuerst, und der Auslöser startet welcome.
Probier es selbst
- Füge einen Parameter
markfür das Rahmenzeichen hinzu, mit dem Standardwert'*'. Rahme „Oak Hill“ mit#und die Creeper-Warnung mit!ein.
Lösung
mark ist ein CHAR, ein einzelnes Zeichen, geschrieben '*'. Es ersetzt jedes "*" in framed. Der erste Aufruf lässt es weg und bekommt Sterne.
PROGRAM frame
NOOP
CONSTANT BASE STRING "Oak Hill"
NOOP
FUNCTION framed
PARAMETER text STRING
PARAMETER row INTEGER 0
PARAMETER column INTEGER 0
PARAMETER mark CHAR '*'
RESULT width INTEGER
BEGIN
VARIABLE border STRING
IF text = "" ;
BEGIN
RETURN
END IF
CALL LEN
PARAMETER value text ;
RESULT result width
ASSIGN width width + 4 ;
FOR i INTEGER 1 ; width ;
BEGIN
ASSIGN border border ⊕ mark ;
END FOR
CALL LOCATE
PARAMETER row row ;
PARAMETER column column ;
CALL PRINT
PARAMETER value border ;
CALL LOCATE
PARAMETER row row + 1 ;
PARAMETER column column ;
CALL PRINT
PARAMETER value mark ⊕ " " ⊕ text ⊕ " " ⊕ mark ;
CALL LOCATE
PARAMETER row row + 2 ;
PARAMETER column column ;
CALL PRINT
PARAMETER value border ;
END FUNCTION
NOOP
FUNCTION welcome
BEGIN
VARIABLE used INTEGER
CALL CLS
CALL framed
PARAMETER text "Welcome" ;
RESULT width used
CALL framed
PARAMETER text BASE ;
PARAMETER column used + 1 ;
PARAMETER mark '#' ;
CALL framed
PARAMETER text "Mind the creepers!" ;
PARAMETER row 4 ;
PARAMETER mark '!' ;
END FUNCTIONDie Wand zeigt den „Welcome“-Rahmen aus Sternen, den „Oak Hill“-Rahmen aus # und die Creeper-Warnung aus !.
- Ändere den ersten Aufruf in
PARAMETER text "" ;. Was zeigt die Wand, und warum?
Lösung
Der erste Rahmen ist weg, und der „Oak Hill“-Rahmen beginnt in Spalte 1. framed ist sofort zurückgekehrt, also hat sein Ergebnis width seinen Startwert 0 behalten, und used + 1 ist 1.