[MySQL API] mysql_free_result()

질의 결과를 메모리에서 해제

【형식】
    mysql_free_result ( resource $result )
      

mysql_free_result()는 result 지시자와 관련된 점유 메모리를 해제한다.

mysql_free_result()는 결과 집합으로부터 질의에 사용되고 있는 메모리의 크기가 커서 문제가 발생할 수 있을 때 사용된다. 모든 연관된 결과 메모리는 스크립트 실행이 종료되면 메모리에서 자동적으로 해지된다.

인수

result 
    mysql_query() 호출을 통한 결과 resource.


반환값
    성공할 경우 TRUE를, 실패할 경우 FALSE를 반환한다. 

result에 비-자원(non-resource) 변수가 사용이 되면, E_WARNING 등급의 에러가 발생될 것이다. 이것은 SELECT, SHOW, EXPLAIN, DESCRIBE 질의로 resource를 반환하는 mysql_query()만으로는 의미가 없다.

【예제】☜
<?php
$result = mysql_query("SELECT id,email FROM people WHERE id = '42'");
if (!$result) {
    echo 'Could not run query: ' . mysql_error();
    exit;
}
/* Use the result, assuming we're done with it afterwords */
$row = mysql_fetch_assoc($result);

/* Now we free up the result and continue on with our script */
mysql_free_result($result);

echo $row['id'];
echo $row['email'];
?> 

주의
Note: 하위 호환을 위하여, 다음의 권장하지 않는 별칭을 사용할 수 있다:
        mysql_freeresult()