FATS - Fast Access Tree System Inhaltsverzeichnis Befehlsübersicht "MB" Build Matchcode

"MB" Build Matchcode

---

Syntax des Kommandostrings:

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

FileNo	Nummer der Indexdatei
RecID	<> 0 Datensatz- bzw. ID-Nummer == 0 Matchcode-Indizierung beenden
Col#data	Inhalt der Datenspalte #
[ ]	Optional

Zusammenfassung:

Inhalte der Datenspalten in den Matchcode-Index einfügen.

Beschreibung:

Dieser Befehl ergänzt den Matchcode-Index um den Inhalt der Spalten bzw. Felder eines Datensatzes und ordnet diesem Satz die über "RecID" angegebene Datensatz- bzw. ID-Nummer zu. Verwenden Sie diesen Befehl, um nach einem erfolgreichen  Create Matchcode File (MC) - Befehl innerhalb einer Programmschleife den Inhalt aller Datensätze in den Matchcode-Index einzufügen. Der Befehl steht nur bei einem kompletten Neuaufbau des Matchcode Indizes bereit, d.h. unmittelbar nach Ausführung des "MC"-Kommandos, spätere Änderungen am Index werden über den  Insert Matchcode (MI) - Befehl realisiert.

Die Position der Datenspalten ("Col#data") innerhalb des Kommandostrings entspricht der beim Aufruf des Befehls Create Matchcode File festgelegten Definition. Das im Kommandostring verwendete Trennzeichen (Standard: Backslash) sollte nicht im übergebenden Text der Datenspalten vorkommen, da dadurch die Reihenfolge der Datenspalten verändert würde.

Bei der Indizierung sequentieller Datenbestände sollte die über "RecID" spezifizierte Nummer der physikalischen Datensatznummer entsprechen, d.h. der erste Datensatz hat die Nummer 1, der zweite Satz die Nummer 2 etc., bei als gelöscht markierten Datensätzen wird der Inhalt der Datenspalten nicht mit angegeben ("MB\{FileNo}\{RecID}").
Der Build Matchcode (MB) - Befehl verlangt eine aufsteigende Nummer als "RecID"-Argument, d.h. der Matchcode kann normalerweise nicht in der logischen Ordnung eines Indizes indiziert werden.

Spätere Matchcode-Abfragen stellen dem Anwendungsprogramm als Ergebnis die über diesen Befehl festgelegte Datensatz- bzw. ID-Nummer ("RecID") in der Variable RECNO zur Verfügung.

Das Kommando "MB\{FileNo}\0" beendet die Indizierung des Matchcode und schließt die entsprechende Matchcode- bzw. Indexdatei. Die Datei wird bei einem durch Fehler bedingten vorzeitigen Abbruch der Indizierung automatisch geschlossen. In jedem Fall kann ein anschließendes Close-Kommando unterbleiben.

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$ = "MB\1\"+STR$(RECNO)+"\"+COL1$+"\"+COL2$

 BASIC Beispiel
 Pascal Beispiel
 C Beispiel

Siehe auch:

 "MI" Insert Matchcode; Seite 4-68
 "MC" Create Matchcode File; Seite 4-56

© 2008  GCS Software, Udo Gertz