.\"modify an array .TH map_array 3 "5 Sep 1994" MudOS "LPC Library Functions" .SH NAME map_array() - modify an array of elements via application of a function .SH SYNOPSIS .nf mixed *map_array( mixed *arr, string fun, object ob, mixed extra, ... ); mixed *map_array( mixed *arr, function f, mixed extra, ... ); .SH DESCRIPTION Returns an array holding the items of `arr' mapped through either `ob->fun()' or 'f'. The function is called for each element in 'arr' with that element as a parameter. A second parameter `extra' is sent in each call if given. Principal function: .IP .nf foreach (index) arr[index] = ob->fun(arr[index],extra); .PP 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. .SH SEE ALSO filter_array(3), sort_array(3), map(3)