ibase_blob_cancel

Synopsis

Returns

TRUE on success, FALSE on error

Description

Discards a BLOB created with ibase_blob_create() . If you, for some reason, don't want to insert a BLOB you created into the database, you should discard it. All BLOBs created during your programs execution must be either closed and inserted into the database or discarded. Otherwise they continue to use internal resources in the database and you also risk losing data.

Note that you can't use this function to delete a BLOB already existing in the database. InterBase handles deleting existing BLOBs itself when you either delete the row containing a BLOB, set the BLOB column to NULL, or replace it with a new BLOB.

Example

// Adjust the ibase_connect() values for your environment
$conn = ibase_connect("c:\\employees.gdb", 'SYSDBA', 'masterkey');

// Create, populate, and cancel the blob
$blobby = ibase_blob_create($conn);
ibase_blob_add($blobby, "Foo Bar Quux Baaz Kazaam!")
   || die("Couldn't add to blob on line " . __LINE__ . "\n");
ibase_blob_cancel($blobby);