<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/ref.mysql.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'es',
  ),
  'this' => 
  array (
    0 => 'function.mysql-free-result.php',
    1 => 'mysql_free_result',
    2 => 'Libera la memoria del resultado',
  ),
  'up' => 
  array (
    0 => 'ref.mysql.php',
    1 => 'Funciones MySQL',
  ),
  'prev' => 
  array (
    0 => 'function.mysql-field-type.php',
    1 => 'mysql_field_type',
  ),
  'next' => 
  array (
    0 => 'function.mysql-get-client-info.php',
    1 => 'mysql_get_client_info',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'es',
    'path' => 'reference/mysql/functions/mysql-free-result.xml',
  ),
  'history' => 
  array (
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="function.mysql-free-result" class="refentry">
 <div class="refnamediv">
  <h1 class="refname">mysql_free_result</h1>
  <p class="verinfo">(PHP 4, PHP 5)</p><p class="refpurpose"><span class="refname">mysql_free_result</span> &mdash; <span class="dc-title">Libera la memoria del resultado</span></p>

 </div>

 <div id="function.mysql-free-result-refsynopsisdiv">
  <div class="warning"><strong class="warning">Advertencia</strong>
   <p class="para">Esta extensión
estaba obsoleta en PHP 5.5.0, y fue eliminada en PHP 7.0.0. En su lugar, se puede
utilizar la extensión <a href="book.mysqli.php" class="link">MySQLi</a> o la extensión
<a href="ref.pdo-mysql.php" class="link">PDO_MySQL</a>. Ver también
<a href="mysqlinfo.api.choosing.php" class="link">MySQL: elegir una API</a> de la guía.
Alternativas a esta función:</p>
   <ul class="simplelist">
    <li><span class="function"><a href="mysqli-result.free.php" class="function">mysqli_free_result()</a></span></li>
    <li>Asignar el valor de <strong><code><a href="reserved.constants.php#constant.null">null</a></code></strong> al objeto PDO, o <span class="methodname"><a href="pdostatement.closecursor.php" class="methodname">PDOStatement::closeCursor()</a></span></li>
   </ul>
  </div>
 </div>

 <div class="refsect1 description" id="refsect1-function.mysql-free-result-description">
  <h3 class="title">Descripción</h3>
  <div class="methodsynopsis dc-description">
   <span class="methodname"><strong>mysql_free_result</strong></span>(<span class="methodparam"><span class="type"><a href="language.types.resource.php" class="type resource">resource</a></span> <code class="parameter">$result</code></span>): <span class="type"><a href="language.types.boolean.php" class="type bool">bool</a></span></div>

  <p class="simpara">
   <span class="function"><strong>mysql_free_result()</strong></span> liberará toda la memoria
   asociada con el identificador del resultado <code class="parameter">result</code>.
  </p>
  <p class="simpara">
   <span class="function"><strong>mysql_free_result()</strong></span> solo necesita ser llamado si
   se está preocupado por la cantidad de memoria que está siendo usada por las consultas
   que devuelven conjuntos de resultados grandes. Toda la memoria de resultados asociada
   se liberará automaticamente al finalizar la ejecución del script.
  </p>
 </div>


 <div class="refsect1 parameters" id="refsect1-function.mysql-free-result-parameters">
  <h3 class="title">Parámetros</h3>
  <dl>
   
<dt><code class="parameter">result</code></dt><dd><p class="para">
 La <span class="type"><a href="language.types.resource.php" class="type resource">resource</a></span> de resultado que acaba de ser evaluada.
 Este resultado proviene de la llamada a la función <span class="function"><a href="function.mysql-query.php" class="function">mysql_query()</a></span>.
</p></dd>
  </dl>
 </div>


 <div class="refsect1 returnvalues" id="refsect1-function.mysql-free-result-returnvalues">
  <h3 class="title">Valores devueltos</h3>
  <p class="simpara">
   Esta función retorna <strong><code><a href="reserved.constants.php#constant.true">true</a></code></strong> en caso de éxito o <strong><code><a href="reserved.constants.php#constant.false">false</a></code></strong> si ocurre un error.
  </p>
  <p class="simpara">
   Si se utiliza un recurso no válido para <code class="parameter">result</code>,
   se emitirá un error de nivel E_WARNING. Vale la pena señalar que
   <span class="function"><a href="function.mysql-query.php" class="function">mysql_query()</a></span> solo devuelve un <span class="type">recurso</span>
   para las consultas SELECT, SHOW, EXPLAIN, y DESCRIBE.
  </p>
 </div>


 <div class="refsect1 examples" id="refsect1-function.mysql-free-result-examples">
  <h3 class="title">Ejemplos</h3>
  <div class="example" id="example-1">
   <p><strong>Ejemplo #1 Un ejemplo de <span class="function"><strong>mysql_free_result()</strong></span></strong></p>
   <div class="example-contents">
<div class="phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br />$resultado </span><span style="color: #007700">= </span><span style="color: #0000BB">mysql_query</span><span style="color: #007700">(</span><span style="color: #DD0000">"SELECT id, email FROM people WHERE id = '42'"</span><span style="color: #007700">);<br />if (!</span><span style="color: #0000BB">$resultado</span><span style="color: #007700">) {<br />    echo </span><span style="color: #DD0000">'No se pudo ejecutar la consulta: ' </span><span style="color: #007700">. </span><span style="color: #0000BB">mysql_error</span><span style="color: #007700">();<br />    exit;<br />}<br /></span><span style="color: #FF8000">/* Usamos el resultado, asumiendo que, acto seguido, hemos terminado con él */<br /></span><span style="color: #0000BB">$fila </span><span style="color: #007700">= </span><span style="color: #0000BB">mysql_fetch_assoc</span><span style="color: #007700">(</span><span style="color: #0000BB">$resultado</span><span style="color: #007700">);<br /><br /></span><span style="color: #FF8000">/* Ahora liberamos el resultado y continuamos con nuestro script */<br /></span><span style="color: #0000BB">mysql_free_result</span><span style="color: #007700">(</span><span style="color: #0000BB">$resultado</span><span style="color: #007700">);<br /><br />echo </span><span style="color: #0000BB">$fila</span><span style="color: #007700">[</span><span style="color: #DD0000">'id'</span><span style="color: #007700">];<br />echo </span><span style="color: #0000BB">$fila</span><span style="color: #007700">[</span><span style="color: #DD0000">'email'</span><span style="color: #007700">];<br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
   </div>

  </div>
 </div>


 <div class="refsect1 notes" id="refsect1-function.mysql-free-result-notes">
  <h3 class="title">Notas</h3>
  <blockquote class="note"><p><strong class="note">Nota</strong>: 
   <span class="simpara">
    Por razones de compatibilidad ascendente,
el siguiente alias obsoleto puede ser utilizado: 
    <span class="function"><strong>mysql_freeresult()</strong></span>
   </span>
  </p></blockquote>
 </div>


 <div class="refsect1 seealso" id="refsect1-function.mysql-free-result-seealso">
  <h3 class="title">Ver también</h3>
  <ul class="simplelist">
   <li><span class="function"><a href="function.mysql-query.php" class="function" rel="rdfs-seeAlso">mysql_query()</a> - Enviar una consulta MySQL</span></li>
   <li><span class="function"><a href="function.is-resource.php" class="function" rel="rdfs-seeAlso">is_resource()</a> - Determina si una variable es un recurso</span></li>
  </ul>
 </div>

</div><?php manual_footer($setup); ?>