Procedure SetElementAdd(Setname, Elempar, Newname)

SetElementAdd

With the procedure SetElementAdd you can add new elements to a one-dimensional set. When you apply SetElementAdd to a root set, the element will be added to that root set. When you apply it to a subset, the element will be added to the subset as well as to all its supersets, up to and including its associated root set.

SetElementAdd(
     Setname,   ! (input/output) a reference to a simple set
     Elempar,   ! (output) an element parameter
     Newname    ! (input) a scalar string expression
     )

Arguments

Setname

The root set or subset to which you want to add the element. This set cannot be an indexed set, nor a set that is an element in an indexed set.

Elempar

An element parameter into Setname, that on return will point to the newly added element.

Newname

A string holding the name of the element to be added.

Note

If the element already exists in the set, the procedure does not make any changes to the set, and on return the element parameter Elempar will point to the existing element.

Example

Given the declarations:

Set s_products;
Set s_fastMovingProducts {
    SubsetOf: s_products;
}
ElementParameter ep_newProd {
    Range: s_products;
}

The code

SetElementAdd(
    Setname :  s_fastMovingProducts,
    Elempar :  ep_newProd,
    Newname :  "p0");

display s_products, s_fastMovingProducts, ep_newProd ;

Will produce in the listing file:

s_products := data { p0 } ;
s_fastMovingProducts := data { p0 } ;
ep_newProd := 'p0' ;

As you can see, the element p0 is added to both s_fastMovingProducts and s_products.

See also