MOVEFPTR

ANSI, NCHAR

The MOVEFPTR instruction retrieves the value of a character string variable's Form Pointer. The instruction uses the following format:

Where:

label

Optional. A Program Execution Label.

source

Required. A previously defined Character String Variable or National Character String Variable whose form pointer is moved to the {dest} variable.

sep

Required. A comma or one of the following prepositions: BY, TO, OF, FROM, USING, WITH, IN, or INTO.

dest

Required. A previously defined Numeric Variable that receives the value of the form pointer from the {source} operand.

Flags Affected: OVER, ZERO

Note the following:

1. The contents of {source} remain unchanged.

2. If {source} is a Null String, the ZERO Condition Flag is set.

3. If the Form Pointer is too large for {dest}, the OVER Condition Flag is set.

4. Enhanced ARRAY processing is supported.

See Also: Example Code, MOVELPTR, MOVEPLEN, Character String Instructions