.TH "PX_GET_DATA_BLOB" "3" 
.SH "NAME" 
PX_get_data_blob \(em Get blob data field 
.SH "SYNOPSIS" 
.PP 
#include <paradox.h> 
.PP 
int PX_get_data_blob(pxdoc_t *pxdoc, char *data, int len, int *mod, int *blobsize, char **value) 
.SH "DESCRIPTION" 
.PP 
Reads a blob data field. This function may be used for all types 
of blobs except for fields of type pxfGraphic. 
.PP 
\fBdata\fP points to the start of the data field in the 
record. It must be calculated by summing up all field length before 
the field to operate on and add it to the base pointer of the 
record. You should use this function instead of accessing the data 
directly. 
.PP 
PX_get_data_blob returns blob data stored in the record itself, or in 
an MB files which must have been set with 
\fBPX_set_blob_file(3)\fP. 
.PP 
The function allocates memory for the data returned in 
\fB*value\fP. This memory has to be freed by the application, 
if the function returns successfully. 
The amount of memory for the blob is returned in 
\fB*blobsize\fP. \fB*mod\fP returns the so called 
modification number of the blob which can often be used as an unique 
id for creating file names, if the data is saved in a file. 
 
.PP 
.RS 
\fBNote:   
.PP 
This function is deprecated and obsolete if 
\fBPX_retrieve_record(3)\fP is used. 
.RE 
.SH "RETURN VALUE" 
.PP 
Returns 0 if the value is NULL, \-1 in case of an error and 1 
otherwise. 
.SH "SEE ALSO" 
.PP 
\fBPX_get_data_graphic(3)\fP, 
\fBPX_get_data_bcd(3)\fP, 
\fBPX_get_data_byte(3)\fP, 
\fBPX_get_data_long(3)\fP, 
\fBPX_get_data_short(3)\fP, 
\fBPX_get_data_double(3)\fP, 
\fBPX_get_data_byte(3)\fP, 
\fBPX_get_data_bytes(3)\fP 		 
.SH "AUTHOR" 
.PP 
This manual page was written by Uwe Steinmann uwe@steinmann.cx. 
.\" created by instant / docbook-to-man