CLEARADR

8.7

The CLEARADR statement clears each pointer variable found in an operand list. This detaches the pointer variable from its previously associated destination variable. The instruction uses the following format:

Where:

label

Optional. A Program Execution Label.

varptr

Required. A PL/B pointer variable or VAR that is cleared.

Flags Affected: NONE

Note the following:

1. {varptr} can be an array that contains pointers. If the {varptr} is an array of pointers, each pointer in the array is cleared.

2. Each {varptr} is detached from any previous variable or pointer. Once a {varptr} variable is detached, the {varptr} variable must be reattached by a MOVEADDR, MOVEPTR, SMAKE, LOADADR, or STOREADR instruction prior to being referenced.

3. Pointers become invalid after a ROLLOUT. They must be re-attached if they are referenced again.

See Also: Example Code, System Interface Instructions