This page in English

Typen und Werte ​

c0de ist statisch typisiert: Jede Variable, Konstante, jeder Parameter und jedes Ergebnis hat genau einen Typ, geschrieben als Typblock hinter seinem Namen. Es gibt kein null, keine automatische Umwandlung von Text in Zahlen und nur zwei Erweiterungen. Diese Lektion geht die Typen durch, ihre Literale und Standardwerte, die Umwandlungen zwischen ihnen und die Konstanten, die jedes Programm kennt, ohne sie zu deklarieren.

Was du brauchst

Eine Kreativwelt mit erlaubten Cheats (siehe Tutorials), einen Auslöserblock, einen Schraubenschlüssel, einen Knopf und zehn nicht initialisierte Variablenkarten. Für die Umwandlungen: eine STRING-Variablenkarte mit dem Namen input.

Die Typen ​

c0deWieLiteralStandardwert
BOOLEANbooleanTRUE, FALSEfalse
INTEGERJava long (64 Bit mit Vorzeichen)42, -70
FLOATJava double3.14, 1.0E200.0
CHARein Unicode-Codepoint'a'ein Leerzeichen
TIMEUnix-Zeit in Millisekunden@2026-10-19T12:05:09Z1970-01-01T00:00:00Z
STRINGJava String"Hello"""
ARRAY Teine Liste von T, ab Index 0–leer
HASH Teine Map von STRING-Schlüsseln auf T–leer
STRUCT nameein Datensatz mit benannten Elementen–Standardwerte aller Elemente
ERROReine Struktur mit code, message, context, line–Code 0

Die ersten fünf sind die einfachen Typen, die anderen die komplexen:

  • STRING kann eine Längenbegrenzung haben: STRING 16. Ein längerer Wert löst STRING_TOO_LONG aus. name[0] liest ein Zeichen als CHAR.
  • Auf ARRAY und HASH folgt immer der Typ ihres Inhalts, zum Beispiel ARRAY INTEGER oder HASH ARRAY STRING. Sie wachsen und schrumpfen von selbst, bis zu 8 Dimensionen.
  • Auf STRUCT folgt der Name einer weiter oben deklarierten Struktur, zum Beispiel STRUCT point. Ihre Elemente erreichst du mit spot.x.
  • ERROR ist der Typ der Fehler (siehe die Lektion „Fehler“); deine eigenen Codes beginnen bei 1000.
  • TIME ist ein Zeitpunkt, keine Dauer. TIME + INTEGER addiert Millisekunden, TIME - TIME ergibt die Millisekunden dazwischen.

Literale gibt es nur für die einfachen Typen und STRING. Arrays, Hashes und Strukturen bekommen ihre Startwerte aus einem Initialisierer: einem Codeblock nach der VARIABLE- oder CONSTANT-Zeile, nur mit Literalen, ohne Ausdrücke.

Das Programm ​

Eine Funktion, die einen Wert jedes Typs zurückgibt:

c0de
PROGRAM typetour
NOOP
NOOP
STRUCT point
BEGIN
    x INTEGER
    y INTEGER
    z INTEGER
END STRUCT
NOOP
FUNCTION values
    RESULT flag BOOLEAN
    RESULT count INTEGER
    RESULT ratio FLOAT
    RESULT letter CHAR
    RESULT moment TIME
    RESULT name STRING 16
    RESULT list ARRAY INTEGER
    RESULT stock HASH INTEGER
    RESULT spot STRUCT point
    RESULT problem ERROR
BEGIN
    VARIABLE primes ARRAY INTEGER
    BEGIN
        2 3 5 7
    END VARIABLE
    VARIABLE chest HASH INTEGER
    BEGIN
        gold 12
        diamond 3
    END VARIABLE
    VARIABLE home STRUCT point
    BEGIN
        x 100
        z -250
    END VARIABLE
    ASSIGN flag 3 > 2 ;
    ASSIGN count 64 * 27 ;
    ASSIGN ratio 7 / 2 ;
    ASSIGN letter 'é' ;
    ASSIGN moment @2026-10-19T12:05:09Z + 250 ;
    ASSIGN name "Steve" ;
    ASSIGN list primes ;
    ASSIGN stock chest ;
    ASSIGN spot home ;
    ASSIGN problem.code 1000 ;
    ASSIGN problem.message "Just a value" ;
END FUNCTION

Starten ​

Stelle den Auslöserblock auf das Programm typetour und die Funktion values ein. Die Funktion hat zehn Ergebnisse und keine Parameter, also lege zehn nicht initialisierte Variablenkarten in sein Eingabeinventar und drücke den Knopf.

Im Ausgabeinventar liegen dann zehn Variablenkarten. Nimm eine in die Haupthand und klicke mit rechts: Der Dialog zeigt ihren Namen, Typ und Wert.

KarteTypWert
flagBOOLEANtrue
countINTEGER1728
ratioFLOAT3.5
letterCHARé
momentTIME2026-10-19T12:05:09.250Z
nameSTRINGSteve
listARRAY INTEGER[2, 3, 5, 7]
stockHASH INTEGER
spotSTRUCT point
problemERRORCode 1000, Meldung "Just a value"

So funktioniert es ​

  • STRUCT point deklariert einen Typ über der Funktion, die ihn verwendet. Ein Name ist erst unterhalb seiner Deklaration bekannt.
  • Der Initialisierer von primes listet Literale auf, die von chest und home einen Schlüssel oder ein Element und ein Literal pro Zeile. Das Element y von home ist nicht aufgeführt, also behält es seinen Standardwert 0.
  • ASSIGN ratio 7 / 2 ; ergibt 3.5: / ergibt immer ein FLOAT, auch bei zwei ganzen Zahlen.
  • @2026-10-19T12:05:09Z + 250 ist eine TIME 250 Millisekunden später.
  • ASSIGN list primes ; kopiert das Array. Komplexe Werte werden immer kopiert, nie geteilt: Wenn du danach list änderst, ändert sich primes nicht.
  • problem ist eine gewöhnliche Variable vom Typ ERROR. Sie als Ergebnis zurückzugeben löst nichts aus; das tun nur RETURN mit ihr oder RAISE.

Umwandlungen ​

c0de wandelt von selbst nur in zwei Richtungen um: Ein INTEGER passt in ein FLOAT und ein CHAR in einen STRING (in ASSIGN, Initialisierern und Literalen). Alles andere ist ein Funktionsaufruf:

Von → nachWieBeispiel
alles → STRING⊕ oder c0de/strings/STR"n=" ⊕ 2.5 ist "n=2.5"
STRING → Zahlc0de/strings/VAL"42" ergibt das FLOAT 42.0 und isInteger true
FLOAT → INTEGERc0de/math/INT (abrunden), FIX (abschneiden), ROUND (zur geraden Zahl)-12.85 → -13, -12, -13
INTEGER → FLOATc0de/math/TO_FLOAT oder einfach zuweisen7 → 7.0
c0de
PROGRAM typeconvert
NOOP
INCLUDE c0de/math
INCLUDE c0de/strings
NOOP
FUNCTION convert
    PARAMETER input STRING "-12.85"
    RESULT number FLOAT
    RESULT whole BOOLEAN
    RESULT down INTEGER
    RESULT cut INTEGER
    RESULT back FLOAT
    RESULT shown STRING
    RESULT joined STRING
BEGIN
    CALL c0de/strings/VAL
        PARAMETER text input ;
        RESULT value number
        RESULT isInteger whole
    CALL c0de/math/INT
        PARAMETER value number ;
        RESULT result down
    CALL c0de/math/FIX
        PARAMETER value number ;
        RESULT result cut
    CALL c0de/math/TO_FLOAT
        PARAMETER value cut ;
        RESULT result back
    CALL c0de/strings/STR
        PARAMETER value back ;
        RESULT result shown
    ASSIGN joined "cut " ⊕ cut ⊕ ", whole " ⊕ whole ;
END FUNCTION

Stelle den Auslöserblock auf das Programm typeconvert und die Funktion convert ein. Lege sieben nicht initialisierte Karten hinein, drücke den Knopf und klicke die Ergebniskarten mit rechts an. Mit dem Standardwert "-12.85" sind die Ergebnisse number -12.85, whole false, down -13, cut -12, back -12.0, shown "-12.0" und joined "cut -12, whole false". Lege jetzt die STRING-Variablenkarte input mit dem Wert " 42 " und sechs nicht initialisierte Karten hinein: input nimmt den Platz von einem Ergebnis ein. VAL ignoriert die Leerzeichen und gibt 42.0 mit isInteger true zurück. Mit "forty-two" löst VAL INVALID_ARGUMENT aus, und der Prozess stürzt mit Exit-Code 15 ab: Der Auslöserblock zeigt den Fehler, und die Karten kommen unverändert heraus.

Bibliotheksfunktionen werden mit CALL aufgerufen, nie in einem Ausdruck; die nächste Lektion erklärt, warum.

Eingebaute Konstanten ​

Jedes Programm kennt diese Konstanten ohne INCLUDE:

KonstanteTypInhalt
SHEETSTRUCT SHEET_INFOdas Blatt des Programms: number, program, owner, x, y, z
PIDSTRUCT PID_INFOder Prozess: pid, program, function, owner, activator (wer ihn gestartet hat), x, y, z und dimension des Auslöserblocks, debug, started
CURSORSTRUCT CURSOR_INFOder Cursor im Moment: line, function, depth, stack_used, stack_size
C0DE_VERSIONSTRINGdie Version von c0de, z. B. "0.5.0"
COLOR_BLACK … COLOR_WHITEINTEGERdie 16 Farben 0 bis 15 von COLOR
DIVISION_BY_ZERO, TYPE_MISMATCH …INTEGERdie Codes der Fehler der Sprache

SHEET und PID werden gefüllt, wenn der Prozess startet. CURSOR ist bei jedem Lesen anders.

Unterschiede, über die du stolpern wirst ​

  • Typen werden geprüft, wenn das Programm läuft, nicht beim Schreiben: Eine Zeile ASSIGN count 7 / 2 ; für einen INTEGER count ist auf dem Blatt grün und löst beim Ausführen TYPE_MISMATCH aus.
  • Es gibt kein null. Eine Variable ohne Startwert enthält den Standardwert ihres Typs, ein Ergebnis auch.
  • Ein INTEGER läuft nicht über wie ein Java-long: 9223372036854775807 + 1 löst NUMERIC_OVERFLOW aus.
  • Ein FLOAT geteilt durch 0.0 löst DIVISION_BY_ZERO aus, anders als IEEE-Gleitkommazahlen in Java, C oder JavaScript. Ein FLOAT, das zu groß wird, wird trotzdem Infinity.
  • "1" + 1 ist ein TYPE_MISMATCH, nicht "11" oder 2. Text wird mit ⊕ zusammengefügt, und Zahlen werden mit VAL aus Text gelesen.
  • VAL gibt immer ein FLOAT zurück. FIX macht daraus einen INTEGER.
  • Ein TIME-Literal ohne Versatz, wie @2026-10-19T12:05:09, wird in der Zeitzone des Servers gelesen. Schreibe Z oder +02:00, um sicherzugehen.
  • Arrays und Hashes sind Werte, keine Referenzen: Zuweisen oder Übergeben kopiert sie.

Probier es selbst ​

  1. Ändere den Typ des Ergebnisses name in STRING 3 und starte noch einmal. Was passiert?
Lösung

"Steve" hat 5 Zeichen, also löst das ASSIGN STRING_TOO_LONG aus. Der Prozess stürzt mit Exit-Code 15 ab, und es entstehen keine Ergebniskarten: Die Karten, die du hineingelegt hast, kommen unverändert ins Ausgabeinventar zurück.

  1. Schreibe eine Funktion, die die Nummer ihres Blatts zurückgibt, den Spieler, der sie gestartet hat, Zeile und Tiefe des Cursors, die Nummer der Farbe Rot und den Code von DIVISION_BY_ZERO.
Lösung
c0de
PROGRAM typeconstants
NOOP
NOOP
FUNCTION where
    RESULT sheet INTEGER
    RESULT starter STRING
    RESULT line INTEGER
    RESULT depth INTEGER
    RESULT red INTEGER
    RESULT failure INTEGER
BEGIN
    ASSIGN sheet SHEET.number ;
    ASSIGN starter PID.activator ;
    ASSIGN line CURSOR.line ;
    ASSIGN depth CURSOR.depth ;
    ASSIGN red COLOR_RED ;
    ASSIGN failure DIVISION_BY_ZERO ;
END FUNCTION

Mit einem Knopf gestartet, ist starter dein Name. line ist 13, die Zeile des ASSIGN, das CURSOR liest, depth ist 1 in der Einstiegsfunktion, red ist 12 und failure ist 303. sheet ist die Nummer des Blatts, auf dem du es gebaut hast.

Mehr dazu ​