mysql_data_seek(3) [php man page]

MYSQL_DATA_SEEK(3)							 1							MYSQL_DATA_SEEK(3)

mysql_data_seek - Move internal result pointer

SYNOPSIS

       Warning

	      This  extension  is deprecated as of PHP 5.5.0, and will be removed in the future. Instead, the MySQLi or PDO_MySQL extension should
	      be used. See also MySQL: choosing an API guide and related FAQ for more information. Alternatives to this function include:

		     omysqli_data_seek(3)

		     o PDO::FETCH_ORI_ABS

       bool mysql_data_seek (resource  $result, int  $row_number)

DESCRIPTION

       mysql_data_seek(3) moves the internal row pointer of the MySQL result associated with the specified result identifier to point to the spec-
       ified row number. The next call to a MySQL fetch function, such as mysql_fetch_assoc(3), would return that row.

       $row_number starts at 0. The $row_number should be a value in the range from 0 to mysql_num_rows(3) - 1. However if the result set is empty
       (mysql_num_rows(3) == 0), a seek to 0 will fail with a E_WARNING and mysql_data_seek(3) will return FALSE.

	      o $
		result -The result resource that is being evaluated. This result comes from a call to mysql_query(3).

	      o $row_number
		- The desired row number of the new result pointer.

	Returns TRUE on success or FALSE on failure.

       Example #1

	      mysql_data_seek(3) example

	      <?php
	      $link = mysql_connect('localhost', 'mysql_user', 'mysql_password');
	      if (!$link) {
		  die('Could not connect: ' . mysql_error());
	      }
	      $db_selected = mysql_select_db('sample_db');
	      if (!$db_selected) {
		  die('Could not select database: ' . mysql_error());
	      }
	      $query = 'SELECT last_name, first_name FROM friends';
	      $result = mysql_query($query);
	      if (!$result) {
		  die('Query failed: ' . mysql_error());
	      }
	      /* fetch rows in reverse order */
	      for ($i = mysql_num_rows($result) - 1; $i >= 0; $i--) {
		  if (!mysql_data_seek($result, $i)) {
		      echo "Cannot seek to row $i: " . mysql_error() . "
";
		      continue;
		  }

		  if (!($row = mysql_fetch_assoc($result))) {
		      continue;
		  }

		  echo $row['last_name'] . ' ' . $row['first_name'] . "<br />
";
	      }

	      mysql_free_result($result);
	      ?>

       Note

	       The function mysql_data_seek(3) can be used in conjunction only with mysql_query(3), not with mysql_unbuffered_query(3).

       mysql_query(3), mysql_num_rows(3), mysql_fetch_row(3), mysql_fetch_assoc(3), mysql_fetch_array(3), mysql_fetch_object(3).

PHP Documentation Group 													MYSQL_DATA_SEEK(3)

Check Out this Related Man Page

MYSQL_FREE_RESULT(3)							 1						      MYSQL_FREE_RESULT(3)

mysql_free_result - Free result memory

SYNOPSIS

       Warning

	      This  extension  is deprecated as of PHP 5.5.0, and will be removed in the future. Instead, the MySQLi or PDO_MySQL extension should
	      be used. See also MySQL: choosing an API guide and related FAQ for more information. Alternatives to this function include:

		     omysqli_free_result(3)

		     oAssign the value of
		       NULL to the PDO object, or PDOStatement::closeCursor

       bool mysql_free_result (resource  $result)

DESCRIPTION

       mysql_free_result(3) will free all memory associated with the result identifier $result.

       mysql_free_result(3) 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.

	      o $
		result -The result resource that is being evaluated. This result comes from a call to mysql_query(3).

	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 mysql_query(3) only returns
       a resource for SELECT, SHOW, EXPLAIN, and DESCRIBE queries.

       Example #1

	      A mysql_free_result(3) example

	      <?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 afterwards */
	      $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

	       For backward compatibility, the following deprecated alias may be used: mysql_freeresult(3)

       mysql_query(3), is_resource(3).

PHP Documentation Group 												      MYSQL_FREE_RESULT(3)

Linux and UNIX Man Pages

mysql_data_seek(3) [php man page]

Check Out this Related Man Page