BLOB RECLAIM()

From Recital Documentation Wiki
Revision as of 11:26, 30 March 2009 by Yvonnemilne (Talk | contribs)

(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search

PURPOSE

Reclaim the space occupied in the memo file


SYNONYM

api_blob_reclaim()


SYNOPSIS

#include "dbapi.h"
 
int	BLOB_RECLAIM(fldname)
 
<input parameters>
char	*fldname;	/* Address of a buffer containing a blob field name	*/
 
<output parameters>
none


DESCRIPTION

The BLOB_RECLAIM() function reclaims the space occupied by a blob in the memo file for the specified field in the current record.


EXAMPLE

The following example deletes the blob on the current record for the blob field specified in the first parameter passed.

#include "dbapi.h"
 
dbapi_blob_reclaim()
{
    int	rc;
 
    if (_parinfo(1) == API_CTYPE) {
       rc = BLOB_RECLAIM(_parc(1));
    } else {
       rc = -1;
    }
 
    _retni( rc )
}


SEE ALSO

BLOB_READ(), BLOB_SIZE(), BLOB_UPDATE(), BLOB_WRITE()