@BSAVE — Saves data from a binary
buffer to a file.
Syntax:
%@BSAVE[bbuf,filename,start,len]
| bbuf | a binary buffer handle returned by @BALLOC |
| filename | the file to save to; will be overwritten if it exists |
| start | the starting address within the buffer; defaults to 0 |
| len | the maximum number of bytes to save; defaults to all through the end of the buffer |
@BSAVE returns the number of bytes written to the file. If
any error occurs while saving the file, @BSAVE returns 0;
the Windows error code is in _BBLASTERR.
See also: @BLOAD.