xHarbour Reference Documentation > Function Reference

BlobGet()

Reads the contents of a memo field holding a binary large object (BLOB).

Syntax

BlobGet( <nFieldPos>, [<nStart>], [<nCount>] ) --> xBlobData

Arguments

<nFieldPos>

This is a numeric value specifying the ordinal position of the memo field holding the BLOB to read.

<nStart>

This is a numeric value specifying the first byte of the BLOB to include in the returned string. If <nStart> is a positive number, data is loaded from the beginning, or the left side, of the BLOB. If <nStart> is a negative number, the data is loaded from the end, or the right side, of the BLOB.

Note:  Both parameters, <nStart> and <nCount>, are ignored if the BLOB does not contain a character string.

<nCount>

This is a numeric value specifying the number of bytes to load, beginning at position <nStart>. If omitted, all bytes from <nStart> to the end of the BLOB are loaded.

Return

The function returns the BLOB data loaded into memory. The data type of a BLOB depends on the stored BLOB. It can be determined using function Valtype(). If the indicated field at position <nFieldPos> is not amemo field, the return value is NIL.

Description

BlobGet() exists for compatibility reasons. It does the same as function FieldGet() but is restricted to memo fields.

Note:  the file Blob.ch must be #included for BlobGet() to work.

Info

See also:	BlobDirectGet(), FieldGet()
Category:	Blob functions , Database functions
Header:	blob.ch
Source:	rdd\dbcmd.c, rdd\dbffpt\dbffpt1.c
LIB:	xhb.lib
DLL:	xhbdll.dll