executeMultiple() joins the prepared SQL statement from prepareQuery() with the given data and does the SQL query for every "row" in the $data array.
query handle from prepareQuery()
if supplied, the types of the columns in the result set will be set for fetching
if supplied, prepareQuery()/ executeQuery() will be used with this array as execute parameters
if supplied, the values in $param will automatically set to the passed datatypes
a numeric array containing the data to insert into the query
Table 39-1. Possible PEAR_Error values
|Error code||Error message||Reason||Solution|
|MDB_ERROR_INVALID||NULL||SQL statement handle is not valid.||Check correct processing of the SQL statement with prepareQuery() . Note that executeMultiple() requires a handle to the statement returned by prepareQuery() , not the statement itself.|
|MDB_ERROR_NEED_MORE_DATA||NULL||To less data for filling the prepared SQL statement.||Check the number of wild cards given in the SQL statement for prepareQuery() . Check the count of entries in the array for $data. The count of entries have to be equal to the number of wild cards.|
|MDB_ERROR_NO_DB_SELECTED||NULL||No database was chosen.||Check the DSN in connect() .|
|every other error code||Database specific error||Check the database related section of PHP-Manual to detect the reason for this error. In the most cases a misformed SQL statement. Ie. using LIMIT in a SQL-Statement for an Oracle database.|
This function can not be called statically.
If an error occurs during execution, the function will be stopped. Possible remaining data will be unprocessed.
See Introduction - Execute for general using and an example.