Description:
------------
---
From manual page: http://www.php.net/function.array-filter
---

The trouble I found with this page is that a common requirement for the filter is to pass extra information for filtering, further than the array elements itself (for example, an external object or a flag that controls the filtering).

I think that the closure method (PHP 5.3+) for passing parameters to the callback function should be prioritized and shown very early in the function docs (in the first screen should be ideal), as is a PHP conformant and very nice/easy method to do it.

I always forget it and I always need a quick google search to find the snippet, that I think (and suggest) it should be in the main page, not even within comments, but as one of the usage examples of the array_filter() function.

Thanks for your consideration.

Regards,

David


Test script:
---------------
<?php

$obj2 = new stdClass();
$obj2->color = 'red';

$external_flag1 = 'green';

$data = array( 'green', 'red', 'blue' );

$filtered_data = array_filter($data, function($color) use ($external_flag1, $obj2) {
	return (($color == $obj2->color) || ($color == $external_flag1));
});

// will act depending on the color of $obj2 object and external_flag1 value
var_dump($filtered_data);

/*
returns:
// blue is removed as the array_filter result for that item is false
array(2) { [0]=> string(5) "green" [1]=> string(3) "red" }
*/


Expected result:
----------------
Looking at the first page of the array_filter() function documentation should expose the closure example (and/or maybe other methods) for a common method to pass external parameters into the callback for the filtering process.


Actual result:
--------------
Actually, you need to dig into the user comments (way down) to find an example, and you must remember yourself that this option exists at all. It should be more explicit, as it forces always to do extra search and find other docs to solve it.