Previous Topic Next topic Print topic


EMPTY Function

Purpose

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

Syntax

EMPTY()

or

EMPTY

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

Description

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

Examples

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

ALLOCATE X IN(A) SET(O);

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

Restrictions

None.

Previous Topic Next topic Print topic