CnCreate

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

handle = CnCreate(dat1, ...)

Return Value

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

Parameters

dat1

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

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

See also

Overview Container, CnDestroy, CnGetAt, CnGetSize, CnAdd, CnSetAt, CnInsertAt, CnRemoveAt, CnPrint

_id-1701002