.\"remove a (key, value) pair from a mapping based on the key
.DT
map_delete
$MUDNAME$ driver help
map_delete
.SH Name
.SI 5
map_delete() - remove a (key, value) pair from a mapping based
on the key
.EI
.SH Synopsis
.SI 5
void map_delete( mapping m, mixed element );
.EI
.SH Description
.SP 5 5
map_delete removes the (key, value) from the mapping `m' that has key equal
to `element'.
For example, given:
.EP
.SI 5
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" ])
.EI
.SP 5 5
keys(names) will not contain "truilkan" after map_delete(names,"truilkan")
is called (unless ("truilkan", *) is subsequently added back to the mapping).
.EP
.SH See also
.SI 5
allocate_mapping()
.EI
