.\"return an array of the keys from the (key, value) pairs in a mapping
.TH keys 3

.SH NAME
keys() - return an array of the keys from the (key, value) pairs in a mapping

.SH SYNOPSYS
mixed * keys(mapping m)

.SH DESCRIPTION
keys() returns an array of keys (indices) corresponding to the keys in
the (key, value) pairs stored in the mapping m.
.PP
For example, if:
.IP
.nf
mapping m;
m = (["hp" : 35, "sp" : 42, "mass" : 100]);
.PP
then
.IP
keys(m) == ({"hp", "sp", "mass"})
.PP
.fi
Note: the keys will not be returned in any apparent order.  However, they
will be returned in the same order as the corresponding values (returned
by the values() efun).

.SH SEE ALSO
values(3), each(3)