Documentation Comments

Use this form to comment on this topic. You can also provide any general observations about the Online Documentation, or request that additional information be added in a future release.

Reality V15.0 ()

MVD command (Proc) (m618403+mvd.htm)

To	Reality
Version
Topic
Submitted by
Company
Location
Email address
Comment

MVD

Deletes data from a multivalued attribute or parameter in the destination buffer.

Syntax

MVD destination source

Syntax Elements

destination is a direct or indirect reference to a buffer or select register from which you want the data deleted.

source is the data you want to delete. The source can be:

a direct or indirect reference to a buffer or select register that contains the data to be deleted.

a string of one or more characters.

Operation

If the source exists more than once in an attribute or parameter, only the first occurrence is deleted.

If the source does not exist, no change occurs.

If the source itself is multivalued, the MVD command has no effect.

If the destination is the primary input buffer, then the buffer pointer is positioned at the beginning of the parameter specified by the destination.

Note: This command cannot function correctly if the values are not in ascending ASCII sequence.

Example 1

Command	File Buffer 2 Before	File Buffer 2 After
`MVD &2.1 FGH`	`000 AB 001 CDE]FGH]IJK 002 IJ`	`000 AB 001 CDE]IJK 002 IJ`

Example 2

001 PQN
002 MV %1 "10",,,,""
003 10 MVA %5 %1
004 F;%1;C1;+;?%1
005 IFN %1 [ 20 GO 10
006 D5
007 S1
008 -1
009 20 MVD %5 %1
010 F;%1;C2;-;?%1
011 IFN %1 > 9 GO 20
012 D5

This Proc builds a multivalued attribute in the 5th parameter of the primary input buffer consisting of the numbers 10 to 20. It then deletes the even numbered values.