CX_DB_UTILITY::RemoveFromCollection

CX_DB_UTILITY::RemoveFromCollection

Beschreibung:

Diese Funktion entfernt ein Objekt aus einer Collection. Das Objekt wird jedoch nicht als solches übergeben, sondern es wird die Adresse des Objektes erwartet, wie sie die Funktion GetLocation liefert.

Diese Funktion ist darauf spezialisiert, korrupte Objekte aus einer Collection zu entfernen. Solche Objekte können in ClassiX^® oft nicht z.B. als Parameter an andere Funktionen übergeben werden. Diese Funktion arbeitet mit der Adresse, was generell ungefährlich ist, solange eine gültige Adresse übergeben wird. Wird eine ungültige Adresse übergeben, dann kann dies zu einem Absturz des Systems führen.

Code-Beispiel:

Var(dbUtil, garbageColl)
GetManager(OBJECT) Call(GetDBUtility) -> dbUtil
FindGarbage(CX_INVOICE) -> garbageColl

Var(corruptObjects)
garbageColl dbUtil Call(FindCorruptObjects) -> corruptObjects
corruptObjects iterate { garbageColl Swap dbUtil Call(RemoveFromCollection)

Funktionsaufruf: Call(RemoveFromCollection)