conIns Function

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:

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

Example

    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;
    
    }

See also

Functions for Manipulating Container Content

conDel Function

conFind Function

conLen Function

conNull Function

conPoke Function

Announcements: To see known issues and recent fixes, use Issue search in Microsoft Dynamics Lifecycle Services (LCS).