blob: 6fe6d1a1a3640338e73974b939960541d252a849 [file] [log] [blame]
m_copy_delete()
***************
FUNKTION
========
mapping m_copy_delete(mapping map, mixed key)
ARGUMENTE
=========
map - das Mapping, aus dem geloescht werden soll.
key - der zu loeschende Eintrag
BESCHREIBUNG
============
Aus dem Mapping map wird der Eintrag key geloescht (wenn er in map vor-
handen ist). map wird dabei nicht veraendert.
RUECKGABEWERT
=============
Eine (flache !) Kopie von map ohne den Eintrag key, d.h. enthaltene
Mappings/Arrays werden nicht kopiert.
BEMERKUNGEN
===========
Das urspruengliche Mapping wird bei dieser Operation nicht veraendert!
Wenn man nur einen Wert aus dem Mapping loeschen will und die Kopie nicht
braucht, bietet sich efun::m_delete(mapping,key) sehr an, da die Erstellung
einer Kopie sehr aufwendig sein kann.
BEISPIELE
=========
mapping m1, m2;
m1 = ([ "a":1, "b":2, "c":3 ]);
m2 = m_copy_delete(m1, "b");
=> m1 = ([ "a":1, "b":2, "c":3 ])
m2 = ([ "a":1, "c":3 ])
m_copy_delete(m1, "a");
=> (es hat sich nichts geaendert)
m1 = m_copy_delete(m1, "a");
=> m1 = ([ "b":2, "c":3 ])
Im letzten Fall sollte aber besser efun::m_delete(m1, "a") benutzt
werden, da ansonsten das Mapping unnoetig kopiert wird und Rechen-
leistung frisst.
SIEHE AUCH
==========
efun::m_delete(E), mappingp(E), mkmapping(E), m_indices,(E) m_values(E),
sizeof(E), widthof(E)