.. highlightlang:: us

.. index:: CnCreate

.. _cncreate:

CnCreate
========

.. us.tag  CnCreate GERMAN Cn.CreateDestroy

:ref:`CnCreate` erzeugt einen Container. Ein Container enthält beliebige Daten
(reelle-, komplexe- oder String-Matrizen).

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

.. us.return

**Returnwert**

*handle* ist die Zugriffsnummer des erzeugten Containers.

.. us.params

**Parameter**

.. uparam:: dat1

   *dat1* ist das erste Datum von maximal 8 Daten (weitere Daten können dem
   Container mit den Funktionen :ref:`CnAdd` oder :ref:`CnInsertAt` hinzugefügt
   werden).

.. us.example

**Beispiel**

Die folgende Anweisung erzeugt einen Container mit drei Daten

::

   * 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:`uberblick-container`,
   :ref:`CnDestroy`

:sub:`id-1701002`