.. highlightlang:: us

.. index:: CnInsertAt

.. _cninsertat:

CnInsertAt
==========

.. us.tag  CnInsertAt ENGLISH

Inserts an element into a container.

.. function::  bool = CnInsertAt(handle, index, dat)

.. us.return

**Return Value**

If the function succeeds, the return value is TRUE (1); otherwise it is FALSE (0).

.. us.params

**Parameters**

.. uparam:: handle

   Identifies the container.

.. uparam:: index

   *index* is the insert position.

.. uparam:: dat

   *dat* is a real, complex or string matrix.

.. seealso::
   :ref:`overview-container`,
   :ref:`CnCreate`

:sub:`id-1417612`