mysqli_stmt_num_rows(3) [php man page]

MYSQLI_STMT_NUM_ROWS(3) 						 1						   MYSQLI_STMT_NUM_ROWS(3)

mysqli_stmt::$num_rows - Return the number of rows in statements result set

       Object oriented style

SYNOPSIS

       int$mysqli_stmt->num_rows ()

DESCRIPTION

       Procedural style
       int mysqli_stmt_num_rows (mysqli_stmt  $stmt)

	Returns   the	number	 of   rows  in	the  result  set.  The	use  of  mysqli_stmt_num_rows(3)  depends  on  whether	or  not  you  used
       mysqli_stmt_store_result(3) to buffer the entire result set in the statement handle.

	If you use mysqli_stmt_store_result(3), mysqli_stmt_num_rows(3) may be called immediately.

PARAMETERS

	      o $
		stmt -Procedural style only: A statement identifier returned by mysqli_stmt_init(3).

RETURN VALUES

	An integer representing the number of rows in result set.

EXAMPLES

       Example #1

	      Object oriented style

	      <?php
	      /* Open a connection */
	      $mysqli = new mysqli("localhost", "my_user", "my_password", "world");

	      /* check connection */
	      if (mysqli_connect_errno()) {
		  printf("Connect failed: %s
", mysqli_connect_error());
		  exit();
	      }

	      $query = "SELECT Name, CountryCode FROM City ORDER BY Name LIMIT 20";
	      if ($stmt = $mysqli->prepare($query)) {

		  /* execute query */
		  $stmt->execute();

		  /* store result */
		  $stmt->store_result();

		  printf("Number of rows: %d.
", $stmt->num_rows);

		  /* close statement */
		  $stmt->close();
	      }

	      /* close connection */
	      $mysqli->close();
	      ?>

       Example #2

	      Procedural style

	      <?php
	      /* Open a connection */
	      $link = mysqli_connect("localhost", "my_user", "my_password", "world");

	      /* check connection */
	      if (mysqli_connect_errno()) {
		  printf("Connect failed: %s
", mysqli_connect_error());
		  exit();
	      }

	      $query = "SELECT Name, CountryCode FROM City ORDER BY Name LIMIT 20";
	      if ($stmt = mysqli_prepare($link, $query)) {

		  /* execute query */
		  mysqli_stmt_execute($stmt);

		  /* store result */
		  mysqli_stmt_store_result($stmt);

		  printf("Number of rows: %d.
", mysqli_stmt_num_rows($stmt));

		  /* close statement */
		  mysqli_stmt_close($stmt);
	      }

	      /* close connection */
	      mysqli_close($link);
	      ?>

	      The above examples will output:

	      Number of rows: 20.

SEE ALSO

       mysqli_stmt_affected_rows(3), mysqli_prepare(3), mysqli_stmt_store_result(3).

PHP Documentation Group 												   MYSQLI_STMT_NUM_ROWS(3)

MYSQLI_STMT_DATA_SEEK(3)						 1						  MYSQLI_STMT_DATA_SEEK(3)

mysqli_stmt::data_seek - Seeks to an arbitrary row in statement result set

       Object oriented style

SYNOPSIS

       void mysqli_stmt::data_seek (int  $offset)

DESCRIPTION

       Procedural style
       void mysqli_stmt_data_seek (mysqli_stmt	$stmt, int  $offset)

	Seeks to an arbitrary result pointer in the statement result set.

       mysqli_stmt_store_result(3) must be called prior to mysqli_stmt_data_seek(3).

PARAMETERS

	      o $
		stmt -Procedural style only: A statement identifier returned by mysqli_stmt_init(3).

	      o $offset
		- Must be between zero and the total number of rows minus one (0.. mysqli_stmt_num_rows(3) - 1).

RETURN VALUES

	No value is returned.

EXAMPLES

       Example #1

	      Object oriented style

	      <?php
	      /* Open a connection */
	      $mysqli = new mysqli("localhost", "my_user", "my_password", "world");

	      /* check connection */
	      if (mysqli_connect_errno()) {
		  printf("Connect failed: %s
", mysqli_connect_error());
		  exit();
	      }

	      $query = "SELECT Name, CountryCode FROM City ORDER BY Name";
	      if ($stmt = $mysqli->prepare($query)) {

		  /* execute query */
		  $stmt->execute();

		  /* bind result variables */
		  $stmt->bind_result($name, $code);

		  /* store result */
		  $stmt->store_result();

		  /* seek to row no. 400 */
		  $stmt->data_seek(399);

		  /* fetch values */
		  $stmt->fetch();

		  printf ("City: %s  Countrycode: %s
", $name, $code);

		  /* close statement */
		  $stmt->close();
	      }

	      /* close connection */
	      $mysqli->close();
	      ?>

       Example #2

	      Procedural style

	      <?php
	      /* Open a connection */
	      $link = mysqli_connect("localhost", "my_user", "my_password", "world");

	      /* check connection */
	      if (mysqli_connect_errno()) {
		  printf("Connect failed: %s
", mysqli_connect_error());
		  exit();
	      }

	      $query = "SELECT Name, CountryCode FROM City ORDER BY Name";
	      if ($stmt = mysqli_prepare($link, $query)) {

		  /* execute query */
		  mysqli_stmt_execute($stmt);

		  /* bind result variables */
		  mysqli_stmt_bind_result($stmt, $name, $code);

		  /* store result */
		  mysqli_stmt_store_result($stmt);

		  /* seek to row no. 400 */
		  mysqli_stmt_data_seek($stmt, 399);

		  /* fetch values */
		  mysqli_stmt_fetch($stmt);

		  printf ("City: %s  Countrycode: %s
", $name, $code);

		  /* close statement */
		  mysqli_stmt_close($stmt);
	      }

	      /* close connection */
	      mysqli_close($link);
	      ?>

	      The above examples will output:

	      City: Benin City	Countrycode: NGA

SEE ALSO

       mysqli_prepare(3).

PHP Documentation Group 												  MYSQLI_STMT_DATA_SEEK(3)