Click above to get retro games delivered to your door ever month!

 AX_BLOB2File()
 Writes a BLOB from a memo field to a file
------------------------------------------------------------------------------

 Syntax

     AX_BLOB2File( <cFileName>, <cFldName> ) -> logical

     <cFileName>  The name of the file to be created to contain the
     BLOB. If a file of this name already exists on the current or
     specified drive, it will be overwritten.

     <cFldName>  The name of the memo field containing the BLOB.

 Returns

     Returns TRUE (.T.) if the BLOB is written to a file, returns
     FALSE (.F.) if not. If .F. is returned, the error code returned
     from the AX_Error() function will give you more information as
     to why the operation failed.

 Description

     AX_BLOB2File() will write a BLOB contained in a memo field out
     to a file. A BLOB is stored in a memo field by using the
     AX_File2BLOB() function.

     The term "BLOB" is an acronym for Binary Large Object, which
     means any type of binary data, not just plain ASCII text, that
     would normally be associated with memo fields.

     Note:  Advantage memos containing BLOBs are not compatible with
     SuccessWare SIx driver memos that contain BLOBs.

     Note:  The CA-Clipper 5.3 dbFileGet() and dbFilePut() functions
     are not directly supported.  The equivalent Advantage functions,
     AX_File2BLOB() and AX_BLOB2File(), are supported.  CA-Clipper 5.3
     BLOBs are not compatible with Advantage BLOBs, however.  Advantage
     implemented BLOB support before CA-Clipper 5.3 added BLOB support
     via the dbFileGet() and dbFilePut() functions.  CA-Clipper chose to
     not obey the existing Advantage BLOB storage format, and instead
     implemented their own format.

 Example

     USE test VIA "DBFNTXAX"  // Open TEST.DBF and TEST.DBT

     // Extract the NOTES field, writing it to the IMAGE.PCX file
     AX_BLOB2File( "IMAGE.PCX", "NOTES" )