Chili Palmer
9b58e0ec43
Setzt den OpenSpec-Change phase-3-isam um (49/49 Aufgaben) und schliesst damit Phase 3 ab. Alle 22 ISAM-Elemente des Inventars sind implementiert; der Abdeckungsstand steigt auf 217 implementiert / 15 offen / 53 Non-Feature. Frontend - ISAM-Anweisungen als eigener Zweig im Parser: NAME [#]n [, arg ...], Sonderform ROLLBACK ALL ueber eine Sentinel-Kennung - 22 Signaturen in builtin_stmt/builtin_fn, neue Argumentart R (Satzvariable eines benutzerdefinierten Typs) - Satzargumente von INSERT/RETRIEVE/UPDATE werden gegen den Typ der Dateinummer geprueft, sofern beide literal bekannt sind - Die Unsupported-Absenkung von OPEN ... FOR ISAM entfaellt Speicherschicht (tb-runtime::isam, einziger Ort mit redb) - Je Tabelle eine Satztabelle satz-id -> Satzbytes, je Index eine Tabelle Schluesselbytes -> satz-id. Satz-IDs sind monoton und werden nie wiederverwendet: der Cursor merkt sich eine ID, eine neu vergebene koennte still auf einen fremden Satz zeigen - Satzbytes entstehen mit fileio::wert_schreiben/wert_lesen, also mit den Recordpuffern und der UTF-32-Festtextkodierung aus datei-eio - Ordnungserhaltende Schluesselkodierung je Spaltentyp; Text als UTF-8, dessen Bytereihenfolge die Codepoint-Reihenfolge ist und damit dieselbe Ordnung wie CmpStr der VM. Ein Eigenschaftstest ueber 5000 zufaellige Wertepaare je Typ haelt fest, dass der Bytevergleich dem fachlichen Vergleich entspricht -- eine Ordnungsverletzung faellt sonst erst bei bestimmten Datenwerten auf - Cursor als Wert (aktiver Index, letzte Satz-ID, unpositioniert), nicht als gehaltener Iterator: er ueberlebt Satzaenderungen und Transaktionsgrenzen - Sicherungspunkte ueber ein eigenes Ruecknahmeprotokoll; ROLLBACK ALL bricht die Bibliothekstransaktion direkt ab Semantik durchweg aus der Original-Hilfe - Die Argumentformen stammen erstmals aus den Einzelseiten, nicht nur aus der Themenliste. Das korrigierte eine Annahme des Entwurfs: die Spaltenliste von CREATEINDEX ist keine Zeichenkette mit Trennzeichen, sondern eine Folge einzelner Stringargumente - SEEKEQ mit unvollstaendigem Schluessel schlaegt immer fehl, SEEKGT mit Teilschluessel positioniert wie SEEKGE - Nach SETINDEX ist der erste Satz der neuen Ordnung aktuell, nach DELETE der folgende - Suche ueber den NULL-Index meldet 87, nicht 83; damit hat jeder Code von 81 bis 89 einen Ausloeser - Einzige Erweiterung: ein - vor dem Spaltennamen ordnet absteigend. Die Original-Hilfe kennt bei CREATEINDEX keine Sortierrichtung, die Anforderung verlangt sie. Kollisionsfrei, weil ein TYPE-Feldname nie mit - beginnen kann CLOSE beendet keine Transaktion - Erst schrieb es sie fest, womit das Schliessen irgendeiner Dateinummer die Transaktion aller anderen mit beendete und ein folgendes ROLLBACK ALL ins Leere lief. Ausstehende Aenderungen sind ohnehin festgeschrieben, weil jede Operation ausserhalb einer Transaktion fuer sich eine ist - Ueber das Ende entscheiden allein COMMITTRANS und ROLLBACK ALL; eine beim Programmende offene Transaktion verfaellt, in beiden Wegen gleich SETMEM und Fehler 89 - Ohne DOS-Speichermodell ist SETMEM die Obergrenze des ISAM-Puffers (Vorgabe 65536 Bytes); ohne echte Grenze waere Code 89 nie erreichbar und die Anweisung eine Attrappe Tests - 18 Einheitentests (Kodierung, Formatversion, Satz-IDs, Roundtrip ueber alle Feldtypen, Indexordnung, Cursor, Protokoll) - 6 Korpusprogramme: Tabellen, Indizes, Cursor, Saetze, Transaktionen, Puffer und Vergleichsordnung -- je in einem temporaeren Arbeits- verzeichnis, der Projektbaum bleibt sauber - Der VM-Test zu Fehler 73 prueft ISAM nicht mehr, sondern SETUEVENT; dafuer belegt ein neuer Test, dass OPEN ... FOR ISAM arbeitet Dokumentation: Datenbankdateiformat in dateiformate.md, Abschnitt 10a samt Sortierordnung und SETMEM-Abweichung in sprachreferenz.md, ISAM-Abschnitt in bibliothek.md, Inventar auf implementiert, PLAN.md schaerft die Leitplanke Referenzverhalten -- sie gilt auch gegenueber den eigenen Spezifikationen. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
122 lines
2.8 KiB
QBasic
122 lines
2.8 KiB
QBasic
' tb-screen: 80x25
|
|
' tb-tempdir
|
|
' ISAM (Spec isam-datenbank, Anforderung "Satzoperationen auf dem aktuellen
|
|
' Satz"): INSERT/RETRIEVE feldgleich, UPDATE/DELETE mit unpositioniertem
|
|
' Cursor danach, Fehler 85 ohne aktuellen Satz, Fehler 86 bei Verstoss gegen
|
|
' einen eindeutigen Index mit unveraendertem Bestand, und Indexnachfuehrung
|
|
' nach jeder Satzoperation. Laeuft in einem temporaeren Verzeichnis.
|
|
TYPE Artikel
|
|
Nr AS LONG
|
|
Name AS STRING * 8
|
|
Preis AS DOUBLE
|
|
Menge AS INTEGER
|
|
END TYPE
|
|
DIM a AS Artikel, g AS Artikel
|
|
|
|
ON ERROR GOTO Handler
|
|
OPEN "lager.isam" FOR ISAM Artikel "Artikel" AS #1
|
|
CREATEINDEX #1, "NachNr", 1, "Nr"
|
|
CREATEINDEX #1, "NachName", 0, "Name"
|
|
|
|
' --- 7.1: einfuegen, per SEEKEQ finden und feldgleich zurueckelesen ---
|
|
a.Nr = 100
|
|
a.Name = "Schraube"
|
|
a.Preis = 1.25
|
|
a.Menge = 7
|
|
INSERT #1, a
|
|
a.Nr = 200
|
|
a.Name = "Mutter"
|
|
a.Preis = 0.5
|
|
a.Menge = 3
|
|
INSERT #1, a
|
|
|
|
SETINDEX #1, "NachNr"
|
|
SEEKEQ #1, 100
|
|
RETRIEVE #1, g
|
|
PRINT "gelesen:"; g.Nr; RTRIM$(g.Name); g.Preis; g.Menge
|
|
PRINT "feldgleich:"; (g.Nr = 100) AND (RTRIM$(g.Name) = "Schraube") AND (g.Preis = 1.25) AND (g.Menge = 7)
|
|
|
|
' --- 7.3: RETRIEVE ohne positionierten Cursor meldet 85 ---
|
|
' Hinter dem letzten Satz gibt es keinen aktuellen Satz mehr.
|
|
MOVELAST #1
|
|
MOVENEXT #1
|
|
RETRIEVE #1, g
|
|
|
|
' --- 7.3: UPDATE ohne positionierten Cursor meldet 85 ---
|
|
MOVELAST #1
|
|
MOVENEXT #1
|
|
UPDATE #1, a
|
|
|
|
' --- 7.3: DELETE ohne positionierten Cursor meldet 85 ---
|
|
MOVELAST #1
|
|
MOVENEXT #1
|
|
DELETE #1
|
|
|
|
' --- 7.5: UPDATE der indizierten Spalte fuehrt den Index nach ---
|
|
SETINDEX #1, "NachName"
|
|
PRINT "vor UPDATE:";
|
|
GOSUB Namen
|
|
SEEKEQ #1, "Schraube"
|
|
RETRIEVE #1, g
|
|
g.Name = "Anker"
|
|
UPDATE #1, g
|
|
PRINT "nach UPDATE:";
|
|
GOSUB Namen
|
|
|
|
' --- 7.4: Verstoss gegen einen eindeutigen Index meldet 86 ---
|
|
PRINT "Bestand vor 86:"; LOF(1)
|
|
a.Nr = 200
|
|
a.Name = "Doppelt"
|
|
a.Preis = 9
|
|
a.Menge = 1
|
|
INSERT #1, a
|
|
PRINT "Bestand nach 86:"; LOF(1)
|
|
|
|
' --- 7.2: UPDATE und DELETE; Cursor danach unpositioniert ---
|
|
SETINDEX #1, "NachNr"
|
|
SEEKEQ #1, 200
|
|
RETRIEVE #1, g
|
|
g.Menge = 99
|
|
UPDATE #1, g
|
|
SEEKEQ #1, 200
|
|
RETRIEVE #1, g
|
|
PRINT "nach UPDATE Menge:"; g.Menge
|
|
|
|
' Der Satz mit Nr 200 ist im Index NachNr der letzte; nach seinem Loeschen
|
|
' steht der Cursor am Ende der Tabelle und es gibt keinen aktuellen Satz.
|
|
SEEKEQ #1, 200
|
|
DELETE #1
|
|
PRINT "nach DELETE Bestand:"; LOF(1); "EOF:"; EOF(1)
|
|
RETRIEVE #1, g
|
|
|
|
' Wird dagegen ein Satz mit Nachfolger geloescht, wird dieser der aktuelle.
|
|
SETINDEX #1, "NachNr"
|
|
a.Nr = 300
|
|
a.Name = "Duebel"
|
|
a.Preis = 2
|
|
a.Menge = 5
|
|
INSERT #1, a
|
|
SEEKEQ #1, 100
|
|
DELETE #1
|
|
RETRIEVE #1, g
|
|
PRINT "nach DELETE ist aktuell:"; g.Nr
|
|
|
|
CLOSE #1
|
|
PRINT "fertig"
|
|
END
|
|
|
|
' Namen in der Ordnung des Index NachName ausgeben.
|
|
Namen:
|
|
MOVEFIRST #1
|
|
DO WHILE NOT EOF(1)
|
|
RETRIEVE #1, g
|
|
PRINT " "; RTRIM$(g.Name);
|
|
MOVENEXT #1
|
|
LOOP
|
|
PRINT
|
|
RETURN
|
|
|
|
Handler:
|
|
PRINT "ERR="; ERR
|
|
RESUME NEXT
|