cubrid_num_rows(3) [php man page]

CUBRID_NUM_ROWS(3)							 1							CUBRID_NUM_ROWS(3)

cubrid_num_rows - Get the number of rows in the result set

SYNOPSIS

       int cubrid_num_rows (resource  $result)

DESCRIPTION

	The  cubrid_num_rows(3) function is used to get the number of rows from the query result. You can use it only when the query executed is a
       select statement. When you want to know such value for INSERT, UPDATE, or DELETE query, you have to use the  cubrid_affected_rows(3)  func-
       tion.

	Note: The cubrid_num_rows(3) function can only be used for synchronous query; it returns 0 when it is used for asynchronous query.

PARAMETERS

	      o $result
		-$result comes from a call to cubrid_execute(3), cubrid_query(3) and cubrid_prepare(3)

RETURN VALUES

	Number of rows, when process is successful.

	0 when the query was done in async mode.

	-1, if SQL statement is not SELECT.

       FALSE when process is unsuccessful.

EXAMPLES

       Example #1

	      cubrid_num_rows(3) example

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

	      $req = cubrid_execute($conn, "SELECT * FROM code");

	      $row_num = cubrid_num_rows($req);
	      $col_num = cubrid_num_cols($req);

	      printf("Row Num: %d
Column Num: %d
", $row_num, $col_num);

	      cubrid_disconnect($conn);
	      ?>

	      The above example will output:

	      Row Num: 6
	      Column Num: 2

SEE ALSO

       cubrid_execute(3), cubrid_num_cols(3), cubrid_affected_rows(3).

PHP Documentation Group 													CUBRID_NUM_ROWS(3)

CUBRID_EXECUTE(3)							 1							 CUBRID_EXECUTE(3)

cubrid_execute - Execute a prepared SQL statement

SYNOPSIS

       resource cubrid_execute (resource  $conn_identifier, string  $sql, [int	$option])

DESCRIPTION

       bool cubrid_execute (resource  $request_identifier, [int  $option])

	The  cubrid_execute(3)	function  is used to execute the given SQL statement. It executes the query by using $conn_identifier and SQL, and
       then returns the request identifier created. It is used for simple execution of query, where the parameter binding is not needed. In  addi-
       tion,  the  cubrid_execute(3)  function is used to execute the prepared statement by means of cubrid_prepare(3) and cubrid_bind(3). At this
       time, you need to specify arguments of $request_identifier and $option.

	The $option is used to determine whether to get OID after query execution and whether to execute the query in synchronous or  asynchronous
       mode.  CUBRID_INCLUDE_OID  and  CUBRID_ASYNC  (or CUBRID_EXEC_QUERY_ALL if you want to execute multiple SQL statements) can be specified by
       using a bitwise OR operator. If not specified, neither of them isselected. If the flag CUBRID_EXEC_QUERY_ALL is	set,  a  synchronous  mode
       (sync_mode) is used to retrieve query results, and in such cases the following rules are applied:

	      oThe return value is the result of the first query.

	      o If an error occurs in any query, the execution is processed as a failure.

	      o  In  a	query composed of q1 q2 q3, if an error occurs in q2 after q1 succeeds the execution, the result of q1 remains valid. That
	      is, the previous successful query executions are not rolled back when an error occurs.

	      o If a query is executed successfully, the result of the second query can be obtained using cubrid_next_result(3).

	If the first argument is $request_identifier to execute the cubrid_prepare(3) function, you can specify an option, CUBRID_ASYNC only.

PARAMETERS

	      o $conn_identifier
		-Connection identifier.

	      o $sql
		-SQL to be executed.

	      o $option
		-Query execution option CUBRID_INCLUDE_OID, CUBRID_ASYNC, CUBRID_EXEC_QUERY_ALL.

	      o $request_identifier
		-cubrid_prepare(3) identifier.

RETURN VALUES

	Request identifier, when process is successful and first param is conn_identifier; TRUE, when process is successful and first argument	is
       request_identifier.

       FALSE, when process is unsuccessful.

CHANGELOG

       +--------+----------------------------------------+
       |Version |					 |
       |	|					 |
       |	|	       Description		 |
       |	|					 |
       +--------+----------------------------------------+
       | 8.4.0	|					 |
       |	|					 |
       |	|  Add new option CUBRID_EXEC_QUERY_ALL. |
       |	|					 |
       +--------+----------------------------------------+
EXAMPLES

       Example #1

	      cubrid_execute(3) example

	      <?php
	      $conn = cubrid_connect("localhost", 33000, "demodb");

	      $result = cubrid_execute($conn, "SELECT code FROM event WHERE name='100m Butterfly' and gender='M'", CUBRID_ASYNC);
	      $row = cubrid_fetch_array($result, CUBRID_ASSOC);
	      $event_code = $row["code"];

	      cubrid_close_request($result);

	      $history_req = cubrid_prepare($conn, "SELECT * FROM history WHERE event_code=?");
	      cubrid_bind($history_req, 1, $event_code, "number");
	      cubrid_execute($history_req);

	      printf("%-20s %-9s %-10s %-5s
", "athlete", "host_year", "score", "unit");
	      while ($row = cubrid_fetch_array($history_req, CUBRID_ASSOC)) {
		  printf("%-20s %-9s %-10s %-5s
",
		      $row["athlete"], $row["host_year"], $row["score"], $row["unit"]);
	      }

	      cubrid_close_request($history_req);

	      cubrid_disconnect($conn);
	      ?>

	      The above example will output:

	      athlete		   host_year score	unit
	      Phelps Michael	   2004      51.25	time

SEE ALSO

       cubrid_prepare(3), cubrid_bind(3), cubrid_next_result(3), cubrid_close_request(3), cubrid_commit(3), cubrid_rollback(3).

PHP Documentation Group 													 CUBRID_EXECUTE(3)