FATS - Fast Access Tree System Inhaltsverzeichnis Befehlsübersicht "MI" Insert Matchcode

"MI" Insert Matchcode

---

Syntax des Kommandostrings:

CMND$ = "MI\{FileNo}\{RecID}\{Col1data}[\{Col2data}[\{Col3data}]]"

FileNo	Nummer der Indexdatei
RecID	Datensatz- bzw. ID-Nummer
Col#data	Inhalt der Datenspalte X
[ ]	Optional

Zusammenfassung:

Neuanlage bzw. Update eines Datensatzes im Matchcode Index.

Beschreibung:

Dieser Befehl fügt den Inhalt der Datenspalten ("Col#data") des über "RecID" spezifizierten Datensatzes dem Matchcode Index hinzu.

Die Position der Datenspalten ("Col#data") innerhalb des Kommandostrings entspricht der beim Aufruf des Befehls Create Matchcode File (MC) festgelegten Definition. Die Syntax des Kommandostrings entspricht der des Befehls  Build Matchcode (MB).

Bitte beachten Sie, daß bei der Änderung eines bereits indizierten Datensatzes zuerst mit dem Befehl  Delete Matchcode (MD) dessen bisheriger Inhalt (vor der Änderung) aus dem Matchcode-Index entfernt werden muß, bevor der neue Inhalt mit diesem Befehl wieder eingefügt wird.

Bei der Neuerstellung bzw. Reorganisation des Matchcode-Indizes sollte aus Geschwindigkeitsgründen immer der Befehl Build Matchcode (MB) anstatt diesem Befehl angewandt werden.

Wenn bei der Erstellung der Matchcode-Indexdatei ein Primärschlüssel definiert wurde (Flag "K#:#"), dann hat die über "RecID" angegebene Datensatz- bzw. ID-Nummer keine Bedeutung, d.h. es muß wie bereits beim "MB"-Befehl der Primärschlüssel über "Col#data" angegeben werden.

Dieser Befehl gehört zur Gruppe der Matchcode-Befehle und wird nur in der erweiterten Version von FATS unterstützt.

Rückgabe:

ERRORCODE:	Fehlercode oder 0 (kein Fehler)
RECNO:	undefiniert
FATSKEY:	undefiniert

Beispiel:

CMND$ = "MI\1\"+STR$(RECNO)+"\"+COL1$+"\"+COL2$

 BASIC Beispiel

Siehe auch:

 "MB" Build Matchcode; Seite 4-53
 "MC" Create Matchcode File; Seite 4-56

© 2008  GCS Software, Udo Gertz