Clipper: (Stand: 23.12.2001)

Datenbanken (.DBF) - Memo-Dateien (.DBT) - Indexdateien (.NTX) - Mem-Dateien (.MEM)

0. Erläuterungen:

• Die Byte-Nummer ist für C/C++-Programme gedacht, die bei der Zählung
  (z. B. bei char cText[]) ja mit 0 beginnen, die Stelle beginnt jedoch
  (z. B. für Clipper Substring nach Lowlevel-Zugriff) bei 1.

• Art W = Wort, 2 Bytes, höchstwertiges Byte ist hinten

• Art DW = Doppelwort, 4 Bytes, Reihenfolge: niedrigstes, zweitniedrigstes,
  zweithöchstes, höchstes Byte

1. Struktur von Clipper-Datenbanken
(Anmerkungen zu anderen Systemen sofern bekannt):

1.1. Kopf (32 Bytes):

1.2. Feldeinträge (32 Bytes), je ein Eintrag pro existierendem Feld:

1.3. Ende Kopf:

• Clipper: zwei Bytes: ASCII 13 = 0DH und ASCII 0 = 00H

• Foxpro: ein Byte: ASCII 13 = 0DH, Visual Foxpro reserviert z. B. manchmal noch
  263 weitere Bytes bis zum eigentlichen Datenbeginn,
  sie sind aber im Feld "Start" (DW Byte 8 und 9) berücksichtigt).
  Falls vorhanden, folgt direkt nach diesem Byte der Name der DBC-Datei, der diese DBF-Datei zugeordnet wurde.

1.4. Satz:

Die erste Stelle beinhaltet immer ein Leerzeichen (Blank, " ", ASCII 32, 020H)
für nicht gelöschte Sätze und einen Stern ("*", ASCII 42, 02AH) für gelöschte.
Dieses Zeichen ist bei der Feldlänge - Wort (Byte 10 und 11) - bereits berücksichtigt!
Anschließend folgen die Feldinhalte. Sie stehen ohne Trennungszeichen direkt
hintereinander.
Maximal 1 Milliarde Sätze pro Datenbank!

Feldinhalte:

1.5. Datenende: ein Byte, CTRL-Z = STRG-Z = ASCII 26 = 1AH.
Hinweis: Dieses Byte kann auch fehlen!

1.6. Programmierbeispiel in Clipper

1.7. Programmierbeispiel in C

2. Struktur von Clipper-Memo-Dateien (.DBT):

2.1. Kopf (512 Bytes):

2.2. Inhalt:

Die Adresse der Daten in der DBT-Datei für einen bestimmten Satz aus der DBF-Datei erhält man,
in dem man den oben erwähnten 10-Byte-Zeiger heraussucht und mit 512 multipliziert.
Dort stehen die Daten und sind relevant bis vor das erste CTRL-Z (STRG-Z, ASCII 26 = 01AH).

Maximalgröße Daten für einen Satz = 64 KB = 128 Blöcke á 512 Bytes!
Maximalgröße DBT-Datei = 32 MB!

Hinweis: Hat ein Satz ein leeres Memo-Feld, so werden trotzdem 512 Bytes belegt.
Hinweis: Vergrößert sich ein Memo-Feld über die nächste Block-Grenze hinaus, so werden die
Daten ans Ende der DBT-Datei kopiert und die bisherigen Blöcke werden einfach nicht mehr
benutzt. Dieser Speicherplatz ist verloren, bis man ein Pack oder ein Copy durchführt.
Selbstverständlich bekommt man den Speicherplatz auch bei einem Zap wieder zurück <vbg>.

3. Struktur von Clipper-Indexdateien (.NTX):

Clipper-Indexdateien benutzen einen modifizierten B+-Baum-Algorithmus.
Normalerweise haben nur die Blätter (Leafs) Schlüsselwerte (Keys).
Bei Clipper haben auch die Wurzel (Root) und die Äste (Nodes) Schlüsselwerte und Satznummern.

Eine NTX-Datei hat genau einen Kopf-Block und Daten in mindestens einem und maximal drei Levels
in Abhängigkeit vom Produkt von der Anzahl von Sätzen und der Schlüssel-Länge + 8.
Alle Daten werden in Blöcken von 1024 Bytes abgespeichert.
Kopf-Block und Level-1-Block sind genau einmal vorhanden.
Level-2- und Level-3-Blöcke sind nur bei Bedarf und dann beliebig oft vorhanden.
Die maximale Länge eines Indexschlüssels beträgt 250 Zeichen.

3.1. Kopf (1024 Bytes):

3.2. Level 1-3 (1024 Bytes):

3.3. Indexeintrag (8 Bytes + Schlüssellänge):

Der Schlüssel eines Indexeintrages (nicht unterster Level!) ist echt größer als alle Schlüssel
des untergeordneten Blockes, dessen Adresse sich im selben Indexeintrag befindet.

Der letzte Indexeintrag des obersten Levels hat einen leeren Schlüssel, 00H.
Im zugehörigen, untergeordneten Block befinden sich die höchsten Schlüssel!

3.4. Freie Blöcke:

Der Theorie nach werden freie Blöcke in der Indexdatei beim Freiwerden verkettet und falls nötig wiederverwendet
Die Nummer des ersten freien Blockes befindet sich im Kopf (s. 3.1.).
Ich habe allerdings noch nie gesehen, dass Clipper wirklich freie Blöcke hat.
Vielleicht packe ich meine Dateien dafür auch zu oft?!

3.5. Zugriff auf die Daten in der DBF anhand der Satznummer aus der NTX-Datei:

3.6. Beispiel einer Indexdatei (alle Werte hexadezimal):

4. Struktur von Clipper-Mem-Dateien (.MEM):

Für jede mit "SAVE TO" gespeicherte Variable gibt es einen Kopf (4.1.), der den Feldeinträgen der DBF-Datei (s. 1.2) sehr gleicht.
Hinter dem Kopf werden Daten (variabler Länge, in Abhängigkeit vom Datentyp) wie untenstehend (4.2.) angehängt.
Ende der Informationen s. 4.3.

4.1. Kopf für Variable:

4.2. Inhalt der Variablen, Daten:

4.3. Schlußbyte: CTRL-Z = STRG-Z = ASCII 26 = 01AH

Programm zum Dump einer Mem-Datei

Programmierungs-Seite

Startseite

(www.zelczak.com/clipp_de.htm)