DB2_LOB_READ(3) 							 1							   DB2_LOB_READ(3)

db2_lob_read - Gets a user defined size of LOB files with each invocation

SYNOPSIS

       string db2_lob_read (resource  $stmt, int  $colnum, int	$length)

DESCRIPTION

	Use db2_lob_read(3) to iterate through a specified column of a result set and retrieve a user defined size of LOB data.

PARAMETERS

	      o $stmt
		- A valid stmt resource containing LOB data.

	      o $colnum
		- A valid column number in the result set of the stmt resource.

	      o $length
		- The size of the LOB data to be retrieved from the stmt resource.

RETURN VALUES

	Returns the amount of data the user specifies. Returns FALSE if the data cannot be retrieved.

EXAMPLES

       Example #1

	      Iterating through different types of data

	      <?php

	      /* Database Connection Parameters */
	      $db = 'SAMPLE';
	      $username = 'db2inst1';
	      $password = 'ibmdb2';

	      /* Obtain Connection Resource */
	      $conn = db2_connect($db,$username,$password);

	      if ($conn) {
		  $drop = 'DROP TABLE clob_stream';
		  $result = @db2_exec( $conn, $drop );

		  $create = 'CREATE TABLE clob_stream (id INTEGER, my_clob CLOB)';
		  $result = db2_exec( $conn, $create );

		  $variable = "";
		  $stmt = db2_prepare($conn, "INSERT INTO clob_stream (id,my_clob) VALUES (1, ?)");
		  $variable = "THIS IS A CLOB TEST. THIS IS A CLOB TEST.";
		  db2_bind_param($stmt, 1, "variable", DB2_PARAM_IN);
		  db2_execute($stmt);

		  $sql = "SELECT id,my_clob FROM clob_stream";
		  $result = db2_prepare($conn, $sql);
		  db2_execute($result);
		  db2_fetch_row($result);
		  $i = 0;
		  /* Read LOB data */
		  while ($data = db2_lob_read($result, 2, 6)) {
		      echo "Loop $i: $data
";
		      $i = $i + 1;
		  }

		  $drop = 'DROP TABLE blob_stream';
		  $result = @db2_exec( $conn, $drop );

		  $create = 'CREATE TABLE blob_stream (id INTEGER, my_blob CLOB)';
		  $result = db2_exec( $conn, $create );

		  $variable = "";
		  $stmt = db2_prepare($conn, "INSERT INTO blob_stream (id,my_blob) VALUES (1, ?)");
		  $variable = "THIS IS A BLOB TEST. THIS IS A BLOB TEST.";
		  db2_bind_param($stmt, 1, "variable", DB2_PARAM_IN);
		  db2_execute($stmt);

		  $sql = "SELECT id,my_blob FROM blob_stream";
		  $result = db2_prepare($conn, $sql);
		  db2_execute($result);
		  db2_fetch_row($result);
		  $i = 0;
		  /* Read LOB data */
		  while ($data = db2_lob_read($result, 2, 6)) {
		      echo "Loop $i: $data
";
		      $i = $i + 1;
		  }
	      } else {
		  echo 'no connection: ' . db2_conn_errormsg();
	      }

	      ?>

	      The above example will output:

	      Loop 0: THIS I
	      Loop 1: S A CL
	      Loop 2: OB TES
	      Loop 3: T. THI
	      Loop 4: S IS A
	      Loop 5:  CLOB
	      Loop 6: TEST.
	      Loop 0: THIS I
	      Loop 1: S A BL
	      Loop 2: OB TES
	      Loop 3: T. THI
	      Loop 4: S IS A
	      Loop 5:  BLOB
	      Loop 6: TEST.

SEE ALSO

       db2_bind_param(3), db2_exec(3), db2_execute(3), db2_fetch_row(3), db2_prepare(3), db2_result(3).

PHP Documentation Group 													   DB2_LOB_READ(3)