statement_prepare

Description:

public bool statement_prepare (Statement stmt) throws Error

Ask the database accessed through the this connection to prepare the usage of stmt.

This is only useful if stmt will be used more than once (however some database providers may always prepare statements before executing them).

This function is also useful to make sure stmt is fully understood by the database before actually executing it.

Note however that it is also possible that statement_prepare fails when statement_execute does not fail (this will usually be the case with statements such as <![CDATA["SELECT * FROM #tablename::string"]]> because database usually don't allow variables to be used in place of a table name).

Parameters:

this	a Connection
stmt	a Statement object

Returns:

TRUE if no error occurred.