Skip to main content

This is documentation for Caché & Ensemble.

For information on converting to InterSystems IRIS, see the InterSystems IRIS Adoption Guide and the InterSystems IRIS In-Place Conversion Guide, both available on the WRC Distributions page (login required).

Previous sectionNext section


Moves a value into a buffer or select list.


MV target source
MV target,source
MV target=source


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.


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.


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

MV #2 "ABC","DEF","GHI"
Copy code to clipboard

See Also

  • MVA PROC command

  • MVD PROC command

  • T PROC command

FeedbackOpens in a new window