db2_next_result

(no version information, might be only in CVS)

db2_next_result --  Requests the next result set from a stored procedure

説明

resource db2_next_result ( resource stmt )

警告

この関数は、 実験的なステータスにあります。これは、この関数の 動作、関数名、ここで書かれていること全てがPHPの将来のバージョンで予告 なく変更される可能性があることを意味します。注意を喚起するとともに自分 のリスクでこの関数を使用してください。

A stored procedure can return zero or more result sets. While you handle the first result set in exactly the same way you would handle the results returned by a simple SELECT statement, to fetch the second and subsequent result sets from a stored procedure you must call the db2_next_result() function and return the result to a uniquely named PHP variable.

パラメータ

stmt

A prepared statement returned from db2_exec() or db2_execute().

戻り値

Returns a new statement resource containing the next result set if the stored procedure returned another result set. Returns FALSE if the stored procedure did not return another result set.

例 1. Calling a stored procedure that returns multiple result sets

In the following example, we call a stored procedure that returns three result sets. The first result set is fetched directly from the same statement resource on which we invoked the CALL statement, while the second and third result sets are fetched from statement resources returned from our calls to the db2_next_result() function.

<?php
$conn
= db2_connect($database, $user, $password);

if (
$conn) {
  
$stmt = db2_exec($conn, 'CALL multiResults()');

  print
"Fetching first result set\n";
  while (
$row = db2_fetch_array($stmt)) {
    
var_dump($row);
  }

  print
"\nFetching second result set\n";
  
$res = db2_next_result($stmt);
  if (
$res) {
    while (
$row = db2_fetch_array($res)) {
      
var_dump($row);
    }
  }

  print
"\nFetching third result set\n";
  
$res2 = db2_next_result($stmt);
  if (
$res2) {
    while (
$row = db2_fetch_array($res2)) {
      
var_dump($row);
    }
  }

  
db2_close($conn);
}
?>

上の例の出力は以下となります:

Fetching first result set
array(2) {
  [0]=>
  string(16) "Bubbles         "
  [1]=>
  int(3)
}
array(2) {
  [0]=>
  string(16) "Gizmo           "
  [1]=>
  int(4)
}

Fetching second result set
array(4) {
  [0]=>
  string(16) "Sweater         "
  [1]=>
  int(6)
  [2]=>
  string(5) "llama"
  [3]=>
  string(6) "150.00"
}
array(4) {
  [0]=>
  string(16) "Smarty          "
  [1]=>
  int(2)
  [2]=>
  string(5) "horse"
  [3]=>
  string(6) "350.00"
}

Fetching third result set
array(1) {
  [0]=>
  string(16) "Bubbles         "
}
array(1) {
  [0]=>
  string(16) "Gizmo           "
}