LCMOVE
The LCMOVE instruction moves a single character from the source string to the destination string. The instruction uses the following format:
|
|
|
|
|
Where:
label
Optional. A Program Execution Label.
source
Required. A previously defined Character String Variable that 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 Character String Variable that receives the {source} value.
Flags Affected: EOS
Note the following:
The Length Pointed character in the source string is moved to the first character position in the destination string. The contents of the {source} operand remains unchanged.
No changes are made to the Form Pointers or Length Pointers of operand.
If the Length Pointer of the {source} operand is zero (0), the EOS Condition Flag is set.
This instruction is provided for compatibility only and it use is strongly discouraged.
Example 1:
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
ABCDE····· |
|
|
|
|
|
|
FZDCBA·· |
|
| |||||
|
|
|
|
|
|
ABCDE····· |
|
|
|
|
|
|
EZDCBA·· |
No Condition Flags are set (all FALSE).
Example 2:
|
|
|
|
|
|
|
|
|
|
|
|
|
ABCDE····· |
|
|
|
|
|
|
FEDCBA·· |
|
| |||||
|
|
|
|
|
|
ABCDE····· |
|
|
|
|
|
|
DEDCBA·· |
No Condition Flags are set (all FALSE).
Example 3:
|
|
|
|
|
|
|
|
|
|
|
|
|
ABCDE····· |
|
|
|
|
|
|
FEDCBA·· |
|
| |||||
|
|
| ||||
The EOS Condition Flag is set. The source length pointer is zero.
See Also: CMOVE, Character String Instructions
|
|