oci_fetch(3) [php man page]

OCI_FETCH(3)															      OCI_FETCH(3)

oci_fetch - Fetches the next row from a query into internal buffers

SYNOPSIS

       bool oci_fetch (resource  $statement)

DESCRIPTION

	Fetches  the  next  row  from a query into internal buffers accessible either with oci_result(3), or by using variables previously defined
       with oci_define_by_name(3).

	See oci_fetch_array(3) for general information about fetching data.

PARAMETERS

	      o $statement
		-A valid OCI8 statement identifier created by oci_parse(3) and executed by oci_execute(3), or a REF CURSOR statement identifier.

RETURN VALUES

	Returns TRUE on success or FALSE if there are no more rows in the $statement.

EXAMPLES

       Example #1

	      oci_fetch(3) with defined variables

	      <?php

	      $conn = oci_connect('hr', 'welcome', 'localhost/XE');
	      if (!$conn) {
		  $e = oci_error();
		  trigger_error(htmlentities($e['message'], ENT_QUOTES), E_USER_ERROR);
	      }

	      $sql = 'SELECT location_id, city FROM locations WHERE location_id < 1200';
	      $stid = oci_parse($conn, $sql);

	      // The defines MUST be done before executing
	      oci_define_by_name($stid, 'LOCATION_ID', $locid);
	      oci_define_by_name($stid, 'CITY', $city);

	      oci_execute($stid);

	      // Each fetch populates the previously defined variables with the next row's data
	      while (oci_fetch($stid)) {
		  echo "Location id $locid is $city<br>
";
	      }

	      // Displays:
	      //   Location id 1000 is Roma
	      //   Location id 1100 is Venice

	      oci_free_statement($stid);
	      oci_close($conn);

	      ?>

       Example #2

	      oci_fetch(3) with oci_result(3)

	      <?php

	      $conn = oci_connect('hr', 'welcome', 'localhost/XE');
	      if (!$conn) {
		  $e = oci_error();
		  trigger_error(htmlentities($e['message'], ENT_QUOTES), E_USER_ERROR);
	      }

	      $sql = 'SELECT location_id, city FROM locations WHERE location_id < 1200';
	      $stid = oci_parse($conn, $sql);
	      oci_execute($stid);

	      while (oci_fetch($stid)) {
		  echo oci_result($stid, 'LOCATION_ID') . " is ";
		  echo oci_result($stid, 'CITY') . "<br>
";
	      }

	      // Displays:
	      //   1000 is Roma
	      //   1100 is Venice

	      oci_free_statement($stid);
	      oci_close($conn);

	      ?>

NOTES

       Note

	       Will not return rows from Oracle Database 12 c Implicit Result Sets. Use oci_fetch_array(3) instead.

SEE ALSO

       oci_define_by_name(3), oci_fetch_all(3), oci_fetch_array(3), oci_fetch_assoc(3), oci_fetch_object(3), oci_fetch_row(3), oci_result(3).

PHP Documentation Group 													      OCI_FETCH(3)

Check Out this Related Man Page

OCI_FIELD_SCALE(3)														OCI_FIELD_SCALE(3)

oci_field_scale - Tell the scale of the field

SYNOPSIS

       int oci_field_scale (resource  $statement, mixed  $field)

DESCRIPTION

	Returns the scale of the column with $field index.

	For FLOAT columns, precision is nonzero and scale is -127. If precision is 0, then column is NUMBER. Else it's NUMBER(precision, scale).

PARAMETERS

	      o $statement
		- A valid OCI statement identifier.

	      o $field
		- Can be the field's index (1-based) or name.

RETURN VALUES

	Returns the scale as an integer, or FALSE on errors.

EXAMPLES

       Example #1

	      oci_field_scale(3) Example

	      <?php

	      // Create the table with:
	      //   CREATE TABLE mytab (c1 NUMBER, c2 FLOAT, c3 NUMBER(4), c4 NUMBER(5,3));

	      $conn = oci_connect("hr", "hrpwd", "localhost/XE");
	      if (!$conn) {
		  $m = oci_error();
		  trigger_error(htmlentities($m['message']), E_USER_ERROR);
	      }

	      $stid = oci_parse($conn, "SELECT * FROM mytab");
	      oci_execute($stid, OCI_DESCRIBE_ONLY); // Use OCI_DESCRIBE_ONLY if not fetching rows

	      $ncols = oci_num_fields($stid);
	      for ($i = 1; $i <= $ncols; $i++) {
		  echo oci_field_name($stid, $i) . " "
		      . oci_field_precision($stid, $i) . " "
		      . oci_field_scale($stid, $i) . "<br>
";
	      }

	      // Outputs:
	      //   C1	 0 -127
	      //   C2  126 -127
	      //   C3	 4    0
	      //   C4	 5    3

	      oci_free_statement($stid);
	      oci_close($conn);

	      ?>

NOTES

       Note

	       In  PHP	versions  before  5.0.0  you  must  use  ocicolumnscale(3)  instead.  This name still can be used, it was left as alias of
	      oci_field_scale(3) for downwards compatability. This, however, is deprecated and not recommended.

SEE ALSO

       oci_field_precision(3), oci_field_type(3).

PHP Documentation Group 													OCI_FIELD_SCALE(3)

Linux and UNIX Man Pages

oci_fetch(3) [php man page]

Check Out this Related Man Page