cubrid_fetch(3) [php man page]

CUBRID_FETCH(3) 							 1							   CUBRID_FETCH(3)

cubrid_fetch - Fetch the next row from a result set

SYNOPSIS

       mixed cubrid_fetch (resource  $result, [int  $type = CUBRID_BOTH])

DESCRIPTION

	The  cubrid_fetch(3) function is used to get a single row from the query result. The cursor automatically moves to the next row after get-
       ting the result.

PARAMETERS

	      o $result
		-$result comes from a call to cubrid_execute(3)

	      o $type
		-Array type of the fetched result CUBRID_NUM, CUBRID_ASSOC, CUBRID_BOTH, CUBRID_OBJECT. If you want to operate the lob object, you
		can use CUBRID_LOB.

RETURN VALUES

       Result array or object, when process is successful.

       FALSE, when there are no more rows; NULL, when process is unsuccessful.

       The result can be received either as an array or as an object, and you can decide which data type to use by setting the $type argument. The
       $type variable can be set to one of the following values:

	      oCUBRID_NUM : Numerical array (0-based)

	      oCUBRID_ASSOC : Associative array

	      oCUBRID_BOTH : Numerical & Associative array (default)

	      oCUBRID_OBJECT : object that has the attribute name as the column name of query result

       When $type argument is omitted, the result will be received using CUBRID_BOTH option as default. When you want to receive query	result	in
       object  data  type,  the  column  name  of  the	result must obey the naming rules for identifiers in PHP. For example, column name such as
       "count(*)" cannot be received in object type.

EXAMPLES

       Example #1

	      cubrid_fetch(3) example

	      <?php
	      $conn = cubrid_connect("localhost", 33000, "demodb");
	      $req = cubrid_execute($conn, "SELECT * FROM stadium WHERE nation_code='GRE' AND seats > 10000");

	      printf("%-40s %-10s %-6s %-20s
", "name", "area", "seats", "address");
	      while ($row = cubrid_fetch($req)) {
		  printf("%-40s %-10s %-6s %-20s
",
		      $row["name"], $row["area"], $row["seats"], $row["address"]);
	      }

	      // if you want to operate lob object, you can use cubrid_fetch($req, CUBRID_LOB)

	      cubrid_close_request($req);

	      cubrid_disconnect($conn);
	      ?>

	      The above example will output:

	      name				       area	  seats  address
	      Panathinaiko Stadium		       86300.00   50000  Athens, Greece
	      Olympic Stadium			       54700.00   13000  Athens, Greece
	      Olympic Indoor Hall		       34100.00   18800  Athens, Greece
	      Olympic Hall			       52400.00   21000  Athens, Greece
	      Olympic Aquatic Centre		       42500.00   11500  Athens, Greece
	      Markopoulo Olympic Equestrian Centre     64000.00   15000  Markopoulo, Athens, Greece
	      Faliro Coastal Zone Olympic Complex      34650.00   12171  Faliro, Athens, Greece
	      Athens Olympic Stadium		       120400.00  71030  Maroussi, Athens, Greece
	      Ano Liossia			       34000.00   12000  Ano Liosia, Athens, Greece

SEE ALSO

       cubrid_execute(3), cubrid_fetch_array(3), cubrid_fetch_row(3), cubrid_fetch_assoc(3), cubrid_fetch_object(3).

PHP Documentation Group 													   CUBRID_FETCH(3)

Check Out this Related Man Page

CUBRID_LOB2_READ(3)							 1						       CUBRID_LOB2_READ(3)

cubrid_lob2_read - Read from BLOB/CLOB data.

SYNOPSIS

       string cubrid_lob2_read (resource  $lob_identifier, int	$len)

DESCRIPTION

	The cubrid_lob2_read(3) function reads $len bytes from the LOB data and returns the bytes read.

PARAMETERS

	      o $lob_identifier
		-Lob identifier as a result of cubrid_lob2_new(3) or get from the result set.

	      o $len
		-Length from buffer you want to read from the lob data.

RETURN VALUES

	Returns the contents as a string.

       FALSE when there is no more data.

	NULL on failure.

EXAMPLES

       Example #1

	      cubrid_lob2_read(3) example 1

	      <?php
	      // test_lob (id INT, contents CLOB)

	      $conn = cubrid_connect("localhost", 33000, "demodb", "public", "");

	      $req = cubrid_execute($conn, "select * from test_lob");

	      $row = cubrid_fetch_row($req, CUBRID_LOB);

	      print "position now is " . cubrid_lob2_tell($row[1]) . "
";

	      cubrid_lob2_seek($row[1], 10, CUBRID_CURSOR_FIRST);

	      print "
position after moving farword is " . cubrid_lob2_tell($row[1]) . "
";

	      $data = cubrid_lob2_read($row[1], 12);

	      print "
position after reading is " . cubrid_lob2_tell($row[1]) . "
";

	      print $data . "
";

	      cubrid_lob2_seek($row[1], 5, CUBRID_CURSOR_CURRENT);

	      print "
position after moving again is " . cubrid_lob2_tell($row[1]) . "
";

	      $data = cubrid_lob2_read($row[1], 20);
	      print $data . "
";

	      cubrid_disconnect($conn);
	      ?>

       Example #2

	      cubrid_lob2_read(3) example 2

	      <?php
	      // test_lob (id INT, contents CLOB)

	      $conn = cubrid_connect("localhost", 33000, "demodb", "dba", "");

	      $req = cubrid_execute($conn, "select * from test_lob");

	      $row = cubrid_fetch_row($req, CUBRID_LOB);

	      while (true) {
		  if ($data = cubrid_lob2_read($row[1], 1024)) {
		      print $data . "
";
		  }
		  elseif ($data === false) {
		      print "There is no more data
";
		      break;
		  }
		  else {
		      print "There must some errors
";
		      break;
		  }
	      }

	      cubrid_disconnect($conn);
	      ?>

SEE ALSO

       cubrid_lob2_write(3),   cubrid_lob2_seek(3),   cubrid_lob2_seek64(3),   cubrid_lob2_tell(3),   cubrid_lob2_tell64(3),  cubrid_lob2_size(3),
       cubrid_lob2_size64(3).

PHP Documentation Group 												       CUBRID_LOB2_READ(3)

Linux and UNIX Man Pages

cubrid_fetch(3) [php man page]

Check Out this Related Man Page