CX_JSON_OBJECT::Remove

CX_JSON_OBJECT::Remove
CX_JSON_ARRAY::Remove

Beschreibung:

Diese Methode entfernt den Wert des Feldes mit dem angegebenen Zugriffspfad aus dem JSON-Objekt/-Array. Wenn kein Wert am angegebenem Zugriffspfad vorhanden ist, dann bleibt das JSON-Objekt unverändert. Bei einem JSON-Array wird jedoch ein Fehler geworfen. Sollte man über GetTyped eine Referenz auf ein durch diese Methode entferntes JSON-Objekt halten, so ist die Referenz nicht mehr gültig und kann auch nicht mehr gelesen werden.

Falls Remove auf einem CX_JSON_ARRAY aufgerufen wird, dann kann das erste Element über folgende Zugriffspfade referenziert werden:

0 jsonArray Call(Remove)
"0" jsonArray Call(Remove)
"[0]" jsonArray Call(Remove)
"this[0]" jsonArray Call(Remove)

Code-Beispiel:

Var(config) CreateTransObject(CX_JSON_OBJECT) -> config

"blue" "overrides.color" config Call(PutTyped)  // config= {"overrides":{"color":"blue"}}

"overrides.color"  config Call(GetTyped)    // "blue"

"overrides.color" config Call(Remove)  // config= {"overrides":{}}

"overrides.color"  config Call(GetTyped)    // INVALID

Funktionsaufruf: Call(Remove)