.\"modify an array
.DT
map_array
Discworld driver help
map_array

Name
.SI 5
map_array() - modify an array of elements via application of a function

.EI
Synopsis
.SI 5
mixed *map_array(mixed *arr, string fun, object ob, mixed extra);

.EI
Description
.SP 5 5
Returns an array holding the items of `arr' mapped through `ob->fun()'.
The function `fun' in `ob' is called for each element in `arr' with that
element as parameter. A second parameter `extra' is sent in each call if
given. Principal function: 

`foreach (index) arr[index] = ob->fun(arr[index],extra);'

The value returned by `ob->fun(arr[.index.], extra)' replaces the existing 
element in the array. If `arr' is not an array, then 0 will be returned.
.EP
