MV
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"