MOVELIST


9.6C

 

The MOVELIST instruction allows transfer of the values for each member in the source operand to the corresponding member of the destination operand with a single instruction. The source and destination operands must be a RECORD or VARLIST type. The instruction uses the following format:

 

 

[label]

MOVELIST

{source}{sep}{dest}

 

Where:

label

Optional. A Program Execution Label.

source

Required. A RECORD or VARLIST variable 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 RECORD or VARLIST variable that serves as the destination operand.

Flags Affected: EOS, LESS, OVER, ZERO

Note the following:

  1. The {source} and {dest} RECORDs and VARLISTs do not have be identical when using a MOVELIST.

  2. Each RECORD or VARLIST variable in the {source} is moved to the corresponding variable in the {dest} according to the rules of a MOVE for that variable type.

  3. The MOVELIST allows a RECORD or VARLIST pointer to be specified for the {source} or {dest} operands.

 

 

See Also: Example Code, MOVE

 



PL/B Language Reference MOVE - OBJECT to OBJECT