map_delete(3) LPC Library Functions map_delete(3)
NNAAMMEE
map_delete() - remove a (key, value) pair from a mapping
based on the key
SSYYNNOOPPSSIISS
void map_delete( mapping m, mixed element );
DDEESSCCRRIIPPTTIIOONN
map_delete removes the (key, value) from the mapping m
that has key equal to element.
For example, given:
mapping names;
names = ([]);
names["truilkan"] = "john";
names["wayfarer"] = "erik";
names["jacques"] = "dwayne";
Then:
map_delete(names,"truilkan");
causes the mapping 'names' to be equal to:
(["wayfarer" : "erik", "jacques" : "dwayne"])
keys(names) will not contain "truilkan" after
map_delete(names,"truilkan") is called [unless ("tru-
ilkan", *) is subsequently added back to the mapping].
SSEEEE AALLSSOO
allocate_mapping(3)
MudOS 5 Sep 1994 1