.\"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
