.. highlightlang:: us

.. index:: CnCreate

.. _cncreate:

CnCreate
========

.. us.tag  CnCreate ENGLISH Cn.CreateDestroy

Creates a container. A container can contain one or more matrices.

.. function::  handle = CnCreate(dat1, ...)

.. us.return

**Return Value**

If the function succeeds, the return value *handle* identifies the newly created
container. If the function fails, the return value is zero.

.. us.params

**Parameters**

.. uparam:: dat1

   *dat1* is the first of a maximum of 8 elements (more elements can be added to
   the container with the functions :ref:`CnAdd` or :ref:`CnInsertAt`.

.. us.example

**Example**

The following statements create a container with 3 elements:

::

   * hCont = CnCreate(1, 1+2i, "test")
       1.0000
   * CnPrint(hCont);
       1.0000
       1.0000 + 2.0000i
   test
   * CnGetAt(hCont, 2)
       1.0000 + 2.0000i
   * CnGetAt(hCont, 3)
   test
   * CnInsertAt(hCont, 3, 1:5)
       1.0000
   * CnPrint(hCont);
       1.0000
       1.0000 + 2.0000i
       1.0000     2.0000     3.0000     4.0000     5.0000
   test

.. seealso::
   :ref:`overview-container`,
   :ref:`CnDestroy`,
   :ref:`CnGetAt`,
   :ref:`CnGetSize`,
   :ref:`CnAdd`,
   :ref:`CnSetAt`,
   :ref:`CnInsertAt`,
   :ref:`CnRemoveAt`,
   :ref:`CnPrint`

:sub:`id-1701002`