EMPTY Function

Purpose

Returns an area whose extent is zero. This can be used to free all allocations in an area.

EMPTY()

or

EMPTY

The second syntax form can be used only if EMPTY has been declared with the BUILTIN attribute.

The value returned by this function is the same as the one used by the Compiler to initialize an area when it is allocated.

DECLARE  A AREA,
         O OFFSET(A),
         X FIXED BASED(O);

ALLOCATE X IN(A) SET(O);

A = EMPTY();     /* Frees all allocations in A. */

None.