EFree()

Description

EFree() is used to deallocate the block of memory associated with a pointer.

Call Signature

byte ptr EFree ( any ptr target )

Return Value

byte ptr

A pointer to the block of memory actually freed is returned, though it should not be used to access the memory.

Argument

any ptr target:

This may be a pointer to a basic or user defined type.

Remarks

The block of memory is freed using the C routine HFree(). If the object pointed to is an object of a class with a Destroy() method, the Destroy() method will be invoked on the object.

Example

The following example allocates a large array, passes it as a work space to a user defined function, and then frees the array.

 local integer ptr array
 array = EAlloc( int, F$LEN(list) )
 call MegaSort( list, array )
 EFree( array )

See also

EAlloc()