SelRecDelete

obj -> SelRecDelete(int1) : int

Datensatz aus Selektionsmenge löschen

Details

• obj: Selektionspuffer-Deskriptor
• int1: Dateinummer
• Resultat: int Löschresultat _rOk Löschen erfolgreich _rNoKey Datensatz nicht vorhanden _rNoRec Selektionsmenge ist leer _rNoLock Selektion (handle) nicht gesperrt _rDeadlock Verklemmung aufgetreten _rFailed Zugriff auf temporären Baum nicht möglich (Clients < 5.8.11 erhalten _rNoRec ).
• Siehe: Verwandte Befehle , SelRead () , SelRecInsert ()

Diese Funktion entfernt den aktuell im Hauptspeicher befindlichen Datensatz der Datei (int1) aus einer Ergebnismenge der Selektion im Puffer (obj).

Ist die Ergebnismenge der Selektion unsortiert, reicht es aus die Datensatz-ID des zu entfernenden Datensatzes zu setzen (siehe RecInfo ()). Ist die Ergebnismenge sortiert, muss neben der Datensatz-ID der entsprechende Schlüsselwert gesetzt werden.

Dabei ist zu beachten, dass der Sortierungswert des Satzes in der Ergebnismenge mit dem tatsächlichen Sortierungswerten im Datensatz übereinstimmen muss, da sonst der Datensatz nicht gelöscht werden kann (beispielweise ist die Selektionsmenge nach Namen sortiert, der Name im Datensatz hat sich mittlerweile aber verändert). SelRecDelete() kann sowohl bei der Hauptergebnismenge als auch bei verknüpften Ergebnismengen benutzt werden. Für die Hauptergebnismenge kann in (int1) auch 0 übergeben werden.

Beispiel

// Ersten Datensatz aus einer Selektionsmenge löschen
tHdlSel # SelOpen();
tErg # tHdlSel->SelRead(tblCstCustomer, _SelLock, 'SEL_PLZ');
RecRead(tblCstCustomer, tHdlSel, _RecFirst);
tErg # tHdlSel->SelRecDelete(tblCstCustomer);
...

Mögliche Laufzeitfehler:

• _ErrHdlInvalid: Selektionspuffer-Deskriptor (obj) ungültig
• _ErrFileInvalid: Dateinummer (int1) ungültig