m$replace()
Ein existierendes Element in einer Map überschreiben.
Syntax:
bool |
m$replace ( map_var, string:key, value ) |
Parameter:
map_var |
Die Funktion m$replace erwartetet (wie alle m$*() Funktionen)
als ersten Parameter eine Referenz auf eine (ggf. indizierte) Variable.
Diese Variable wird identisch zu map() zwangsweise in eine Map gewandelt,
um anschließend modifiziert zu werden.
Der Inhalt der Variable map_var wird nicht auf den Stack kopiert.
Stattdessen wird direkt und damit effizient auf den Inhalt der Variable zugegriffen. |
string:key |
Der Schlüssel, unter dem value in die Map eingetragen werden soll.
Der Schlüssel wird zwangsweise mittels string() in eine Zeichenkette gewandelt. |
value |
Ein beliebiger Ausdruck, der in die Map eingetragen werden soll. |
Beschreibung:
Der Wert value wird in die Map map_var unter dem Schlüssel key eingetragen,
aber nur, wenn das Element mit dem Schlüssel key bereits existiert.
Anderenfalls bleibt map_var unverändert.
Funktionsergebnis: BOOL
Als Funktionsergebnis wird genau dann true geliefert,
wenn das Element unter dem Schlüssel key überschrieben wurde.
Siehe auch:
m$insert()
m$store()
m$remove()
m$replaceMap()
Weitere ähnliche Funktionen: