pbms_clear_metadata
Description
pbms_clear_metadata ( [string $name [,resource $pbms]] )
Clears the metadata name and value for $name from the connection. If $name is not supplied then all metadata is removed from the connection.
Parameters
$name
The name of the metadata field to be removed. If not specified then all metadata is removed from the connection.
$pbms
A valid PBMS connection resource. If $pbms is not specified, the last link opened by pbms_connect() is assumed. If no such link is found, it will try to create one as if pbms_connect() was called with no arguments. If by chance no connection is found or established, an E_WARNING level error is generated.
Return Values

Returns TRUE on success.

Returns FALSE on failure. Use pbms_errno() and pbms_error() to retrieve error details.

Example
<?php 
	pbms_connect();

	// Assuming the names are already in the pbms_metadata_header table.
	pbms_add_metadata("Header1", "PHPTest");
	pbms_add_metadata("Blob Name", "Little BLOB");

	
	$blob_ref1 = pbms_put_data("A tiny BLOB");

	pbms_clear_metadata("Blob Name");
	pbms_add_metadata("Blob Name", "A bigger BLOB");

	$blob_ref2 = pbms_put_data("A tiny bit larger BLOB");

	//-----------
	pbms_clear_metadata();
	$blob_ref3 = pbms_put_data("A BLOB with no name.");

	//-----------
	pbms_get_info($blob_ref1); // Get the BLOB info.

	printf("Header1 =  \"%s\"\n", pbms_get_metadata_value("Header1"));
	printf("PHPTest =  \"%s\"\n", pbms_get_metadata_value("Blob Name"));

	//-----------
	pbms_get_info($blob_ref2); // Get the BLOB info.

	printf("Header1 =  \"%s\"\n", pbms_get_metadata_value("Header1"));
	printf("PHPTest =  \"%s\"\n", pbms_get_metadata_value("Blob Name"));

	//-----------
	// Dump the metadata for the BLOB with no name
	pbms_get_info($blob_ref3); // Get the BLOB info.
	$cnt = pbms_reset_metadata(); 
	while ($cnt) {
		$data = pbms_next_metadata();
		printf("%s:%s\n", $data[0], $data[1]);
		$cnt--;
	}

	pbms_close();
?>
		
Related functions
pbms_add_metadata() pbms_reset_metadata() pbms_next_metadata() pbms_get_metadata_value()