Skip to main content
Previous section   Next section

MV

Moves a value into a buffer or select list.

Synopsis

MV target source
MV target,source
MV target=source

Arguments

target The buffer or select list that receives the contents of source. Can be a %n (input buffer), #n (output buffer), or !n (select list) reference.
source The text to be moved to the target buffer or select list. Can be a literal enclosed in quotation marks or a reference to a buffer or select list. Multiple values can be specified as a comma-separated list.

Description

The MV PROC command moves one or more values into a buffer or select list, or moves one or more values from one buffer (or select list) to another. Following the move operation, MV resets the buffer pointer to the beginning of the field(s) that were moved into target.

The three syntactical forms are equivalent. They are provided for compatibility with other MultiValue implementations.

The following source values are supported:

  • "abc" — a literal string. A string may be delimited with single quotes ('abc'), double quotes ("abc"), or backslashes (\abc\).

  • I65 or X41 — a single character in either decimal encoding (Inn) or hexadecimal encoding (Xaa). For further details, refer to the T command.

  • %3, #3, !3 — a numbered input buffer (%3), output buffer (#3) or select list (!3).

  • #3,*2 — the asterisk specifies moving the next n fields from the current pointer position in the specified buffer. In this case, move the first two fields from output buffer 3. An asterisk without a number (for example, #3,*) specifies moving all of the remaining fields from the current pointer position in the specified buffer.

Examples

The following example moves multiple string literals to the output buffer:

MV #2 "ABC","DEF","GHI"

See Also

  • MVA PROC command

  • MVD PROC command

  • T PROC command

Previous section   Next section