====== rsFilter ======
~~NOTOC~~
<WRAP info>
The file ''rsfilter.inc.php'' must be manually included in the script
</WRAP>

<WRAP right box>
== Syntax ==
  obj rsFilter (
       obj &$recordSet,
       string $functionName
       )
</WRAP>
===== Description =====
The method ''rsFilter()'' applies a callback function given by the string ''$functionName'' to all records in an ADOdb recordset given by ''$recordSet''.
===== Parameters =====
==== $recordSet ====
The recordset must be a valid recordset **//passed by reference//** retrieved using a SELECT statement executed with either [[v5:reference:connection:execute|execute()]] or [[v5:reference:connection:selectlimit|selectLimit()]].
==== $functionName ====
The value of ''$functionName'' must point to a valid function that will be used to process the records in the set.
===== Usage =====
<code php>

include_once 'adodb/rsfilter.inc.php';
include_once 'adodb/adodb.inc.php';

/*
* ucwords() every element in the recordset
*/
function doUcwords(&$arr,$rs)
{
     foreach($arr as $k => $v) {
          $arr[$k] = ucwords($v);
     }
}

$db = newADOConnection('mysql');
$db->pConnect('server','user','pwd','db');

$rs = $db->Execute('select ... from table');
$rs = rsFilter($rs,'doUcwords');
</code>