OVRIMOS_FETCH_ROW(3)													      OVRIMOS_FETCH_ROW(3)

ovrimos_fetch_row - Fetches a row from the result set

SYNOPSIS

       bool ovrimos_fetch_row (int  $result_id, [int  $how], [int  $row_number])

DESCRIPTION

	Fetches a row from the result set. Column values should be retrieved with other calls.

PARAMETERS

	      o $result_id
		- A result identifier, returned by ovrimos_execute(3) or ovrimos_exec(3).

	      o $how
		- Determines how the rows are fetched. This can be one of the following strings (case is not significant):

	      +---------+---------------------------------------------------+
	      | Option	|						    |
	      | 	|						    |
	      | 	|			Notes			    |
	      | 	|						    |
	      +---------+---------------------------------------------------+
	      | 	|						    |
	      |  Next	|						    |
	      | 	|						    |
	      | 	|  Forward direction from current position. This is |
	      | 	| the default value.				    |
	      | 	|						    |
	      | 	|						    |
	      |  Prev	|						    |
	      | 	|						    |
	      | 	|     Backward direction from current position.     |
	      | 	|						    |
	      | 	|						    |
	      | First	|						    |
	      | 	|						    |
	      | 	|	  Forward direction from the start.	    |
	      | 	|						    |
	      | 	|						    |
	      |  Last	|						    |
	      | 	|						    |
	      | 	|	   Backward direction from the end.	    |
	      | 	|						    |
	      | 	|						    |
	      |Absolute |						    |
	      | 	|						    |
	      | 	|  Absolute  position  from  the  start.   Requires |
	      | 	| $rownumber.					    |
	      | 	|						    |
	      +---------+---------------------------------------------------+
	      o $rownumber
		- The row number, first one is 0. Only needed when $how is set to Absolute.

RETURN VALUES

	Returns TRUE on success or FALSE on failure.

EXAMPLES

       Example #1

	      A fetch row example

	      <?php
	      $conn = ovrimos_connect("remote.host", "8001", "admin", "password");
	      if ($conn != 0) {
		  echo "Connection ok!";
		  $res=ovrimos_exec($conn, "select table_id, table_name from sys.tables");
		  if ($res != 0) {
		      echo "Statement ok!";
		      if (ovrimos_fetch_row($res, "First")) {
			  $table_id = ovrimos_result($res, 1);
			  $table_name = ovrimos_result($res, 2);
			  echo "table_id=" . $table_id . ", table_name=" . $table_name . "
";
			  if (ovrimos_fetch_row($res, "Next")) {
			      $table_id = ovrimos_result($res, "table_id");
			      $table_name = ovrimos_result($res, "table_name");
			      echo "table_id=" . $table_id . ", table_name=" . $table_name . "
";
			  } else {
			      echo "Next: error
";
			  }
		      } else {
			  echo "First: error
";
		      }
		      ovrimos_free_result($res);
		  }
		  ovrimos_close($conn);
	      }
	      ?>
	This will fetch a row and print the result.

SEE ALSO

       ovrimos_fetch_into(3).

PHP Documentation Group 												      OVRIMOS_FETCH_ROW(3)