
     ffffiiiilllltttteeeerrrr____aaaarrrrrrrraaaayyyy((((3333))))        MMMMuuuuddddOOOOSSSS ((((5555 SSSSeeeepppp 1111999999994444))))         ffffiiiilllltttteeeerrrr____aaaarrrrrrrraaaayyyy((((3333))))

     NNNNAAAAMMMMEEEE
          filter_array() - return a selective sub-array

     SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
          mixed *filter_array( mixed *arr, string fun, object ob,
                               mixed extra, ... );
          mixed *filter_array( mixed *arr, function f, mixed extra, ...);

     DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
          filter_array() returns an array holding the items of <arr>
          which passed sucessfully through the function <fun> found in
          object <ob>.  The function <fun> is called for each element
          in <arr> with that element as parameter.  The second
          parameter <extra> and following parameters are sent in each
          call if given.  An object is considered to have passed
          sucessfully through <fun> (and hence is included in the
          return array) if <fun> returns 1.  If f is passed it is used
          instead of ob->fun().  If <arr> is not an array, then 0 will
          be returned.

     SSSSEEEEEEEE AAAALLLLSSSSOOOO
          sort_array(3), map_array(3)

     Page 1                                          (printed 3/16/95)

