BLOB UPDATE()

From Recital Documentation Wiki
Jump to: navigation, search

PURPOSE

Update a blob


SYNONYM

api_blob_update()


SYNOPSIS

#include "dbapi.h"
 
int	BLOB_UPDATE(fldname, blob, size)
 
<input parameters>
char			*fldname;	/* Address of a buffer containing a blob field name	*/
unsigned char	*blob;	/* Address of a buffer containing the blob data		*/
int			size;		/* Blob size								*/
 
<output parameters>
none


DESCRIPTION

The BLOB_SIZE() function updates a blob field from the specified buffer and overwrites the space used by the blob in the current record.


EXAMPLE

The following example updates the blob field specified in the first parameter passed.

#include "dbapi.h"
 
dbapi_blob_update()
{
    int	result;
 
    if (_parinfo(1) == API_CTYPE && _parinfo(2) == API_CTYPE) {
 
       if (!DBF_ISEXCLUSIVE()) DBF_LOCKR(DBF_RECNO());
       result = BLOB_UPDATE(_parc(1), (unsigned char) _parc(2), _parcsiz(2) );
       if (result) result = DBF_UPDATE();
       if (!DBF_ISEXCLUSIVE()) DBF_UNLOCKR(DBF_RECNO());
 
    } else {
       result = -1;
    }
 
    _retl( (result) ? 1 : 0 );
}


SEE ALSO

BLOB_READ(), BLOB_RECLAIM(), BLOB_SIZE(), BLOB_WRITE()