MOVE - Character String to Character String

ANSI, NCHAR

This MOVE instruction transfers the contents of the source character variable to the destination character variable. The instruction uses the following format:

Where:

label

Optional. A Program Execution Label.

source

Required. A Character String Variable, National Character String Variable, Literal, or National Character String Literal that serves as the source operand.

sep

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

dest

Required. A Character String Variable or National Character String Variable that serves as the destination operand.

Flags Affected: EOS

Note the following:

1. The transfer from the {source} operand begins at the Form Pointed character and continues through the Length Pointed character (i.e., the Logical String) or until {dest} is full (whichever occurs first). The {source} operand remains unchanged.

2. The transfer into {dest} begins at the first physical character. The Form Pointer of {dest} is set to one (1) and the Length Pointer points to the last character moved.

3. If the {dest} is too small for the transfer, the EOS Condition Flag is set.

4. If the source operand is a Null String, the Form Pointer of {dest} is set to Zero and no data is transferred. However, the Length Pointer remains unchanged.

See Also: Example Code, MOVE