## ALP Programming Guide and Reference

[prev][next][parent][TOC]

### PURGE (Remove Macro Definition)

The PURGE directive deletes the definition of a specified macro entry, letting you reuse space.

Syntax

    PURGE   Macro - Name [ , . . . ]

Remarks

It is not necessary to purge a macro before redefining it. You may use PURGE to recover memory during assembly by deleting the contents of unreferenced macros. An Out of Memory condition can occur if a large, general-purpose macro library is included.

Example

The directive:

    PURGE     MACRONAME

performs the same function as redefining the macro with no contents, as in:

    MACRONAME   MACRO
               ENDM

In the following example, assume that MAC1 is a macro included in MACRO.LIB :

    INCLUDE     MACRO . LIB
    PURGE       MAC1
    MAC1        ;   Calls   the   purged   macro
               ;   but   produces   nothing