Switch to: V11V10V9V8V7V6V5

valentina_free_result()

Declaration

bool valentina_free_result ( resource result )

Parameters

Name Description
result The result resource that is being evaluated. This result comes from a call to valentina_query().

Description

valentina_free_result() will free all memory associated with the result identifier result.

valentina_free_result( only needs to be called if you are concerned about how much memory is being used for queries that return large result sets. All associated result memory is automatically freed at the end of the script's execution.

Return Values

Returns TRUE on success or FALSE on failure.

If a non-resource is used for the result, an error of level E_WARNING will be emitted. It's worth noting that valentina_query() only returns a resource for SELECT queries.

Examples

Example 1.

<?php
$result = valentina_query("SELECT id,email FROM people WHERE id = '42'");
if (!$result) {
   echo 'Could not run query: ' . valentina_error();
   exit;
}
/* Use the result, assuming we're done with it afterwords */
$row = valentina_fetch_assoc($result);
 
/* Now we free up the result and continue on with our script */
valentina_free_result($result);
 
echo $row['id'];
echo $row['email'];
?> 

Notes

Note: For downward compatibility, the following deprecated alias may be used: valentina_freeresult()

See Also