BinaryBufInfo

Returns information about the binary buffer.

Syntax:

BinaryBufInfo ( handle, request )

Parameters:

(i) handle: handle of buffer.

(i) request: 0,1, or 2. see below.

Returns:

(i) depends on request.

 

Request

Description

-1

Checks if binary buffer handle is valid. Returns @TRUE if valid, @FALSE if invalid.

0

Get the size of the allocated binary buffer.

1

Get the address of a pointer to a binary buffer. See also IntControl 42

2

Get a pointer to the beginning of the free area just past the already initialized data in a buffer. See also BinaryEodGet

 

Example:


fs = FileSize( "C:\CONFIG.SYS" )
binbuf = BinaryAlloc( fs )
size = BinaryBufInfo(binbuf, 0)
BinaryFree(binbuf)
Message("Size of Binary Buffer", size)
See Also:

Binary Operations, BinaryAlloc, BinaryEodGet, Intcontrol 42