pbms_get_metadata_value
Description
string pbms_get_metadata_value ( string $name [,PBMS $pbms] )
Gets the value for metadata field $name from the connection. If there is more than one field with the same name then which value is returned by this function is undefined.
Parameters
$name
The name of the metadata field to be returned.
$pbms
A valid PBMS connection handle. 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 the value associated with $name on success.

Returns FALSE on failure. Use pbms_errno() and pbms_error() to retrieve error details. If there is no error then $name could not be found.

Example
<?php 
	pbms_connect();

	// Create a BLOB for our test
	$blob_ref = pbms_put_data("A tiny BLOB");

	// Get the BLOB info.
	pbms_get_info($blob_ref); 

	// Get the standard PBMS metadata header BLOB size.
	printf("PBMS_BLOB_SIZE =  %s\n", pbms_get_metadata_value("PBMS_BLOB_SIZE"));
	
	pbms_close();
?>
		
Related functions
pbms_add_metadata() pbms_clear_metadata() pbms_reset_metadata() pbms_next_metadata()