conIns Function [AX 2012]

Updated: December 13, 2013

Applies To: Microsoft Dynamics AX 2012 R2, Microsoft Dynamics AX 2012 Feature Pack, Microsoft Dynamics AX 2012

Inserts one or more elements into a container.


container conIns (
        container container, 
    int start, 
    anytype element,
        ... )

Parameters

Parameter	Description
container	The container into which to insert elements.
start	The position at which to insert elements.
element	One or more elements to insert, separated by commas.

Return Value

The new container with the inserted elements.

Remarks

The first element of the container is specified by the number 1. To insert after the n element, the start parameter should be n+1.

You can also use the += operator to add values of any type into a container. For example, to create a container that contains the squared values of the first 10 loop iterations:

X++

int i;
container c;
;
 
for (i = 1; i < = 10; i++)
{
    c += i*i;
}

Example

X++

static void conInsExample(Args _arg)
{
    container c;
    int i;
    ;
 
    c = conIns(c,1,"item1");  
    c = conIns(c,2,"item2");
    for (i = 1 ; i <= conLen(c) ; i++)  
    {
    // Prints the content of a container.
        print conPeek(c, i);
    }
    pause;

}

Community Additions

ADD