Navigation:  Reference > Functions By Category > Memory > Memory Allocation > _xFree()

Release a memory pointer previously allocated with _xgrab()

 

Syntax:

 

_xFree(<hPointer>)

_xFree(<hPointer>,@<cVar>,<nSize>)

 

Parameters:

 

<hPointer>

Memory pointer to release. Use this function only with pointers obtained with _xGrab()

 

<cVar>

Optionally you can retrieve <nSize> bytes of the memory buffer before release it into a character variable if provided by reference.

 

<nSize>

Number of bytes to store into @<cVar>. If this parameter is ommited <cVar> will contain an empty string.

 

Return Value:

This function always return NIL

 

Remarks:

Use this function only to release pointers obtained with _xGrab(). Attempts to release memory pointers obtained with other methods can result into an internal exception.