| 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) |