TurboPL Referenz

WriteRec

Syntax

WriteRec(Tabelle, Satznummer: Integer): Integer

Kategorie

Datenbank-Befehl

Erklärung

Schreibt den aktuellen Satz an die physikalische Position der angegebenen Satznummer. Falls es sich bei der Satznummer um einen Wert innerhalb der bisherigen Tabellengröße (FileSize) handelt, wird der dort befindliche Satz überschrieben. Ist die Satznummer (um 1) größer als die bisherige Tabellengröße, so wird der Satz angehängt und die Tabelle entsprechend erweitert.

Der Rückgabewert ist die Datensatz-Nummer. Wenn ein Fehler auftritt, wird 0 zurückgegeben und ein Laufzeitfehler ausgelöst.

Beispiel

Das folgende Makro erzeugt einen neuen Datensatz und hängt ihn an die Tabelle an, nachdem zuvor eine Reihe von Vorbelegungen stattgefunden haben.

procedure NeuerSatz
       ReadRec(TableNo, 0)   ..  neuen Satz erzeugen
       SetField(TableNo, 1, "Vorbelegung")
       SetField(TableNo, 2, "Vorbelegung")
       ...
       WriteRec(TableNo, 1+FileSize(TableNo))
endproc

Siehe auch

FirstRec, LastRec, NextRec, PrevRec, ReadRec, SetField