.. highlightlang:: us

.. index:: vcast

.. _vcast:

vcast
=======

.. us.tag  vcast NOTREADYGERMAN Programming.variant New5300

:ref:`vcast` wandelt eine Variant-Matrix in eine Zahlenmatrix, eine String-Matrix
oder eine Matrix mit komplexen Zahlen um. 

Falls die Eingabe-Variant-Matrix Objekte oder COM-Object-Pointer enthält, wird
als Ausgabematrix eine Variant-Matrix erzeugt.

.. function::  m = vcast(vm)
               m = vcast(vm, nType)

.. us.return

**Returnwert**

*m* ist eine Matrix.

.. us.params

**Parameter**

.. uparam:: vm

   *vm* ist eine Variant-Matrix.

.. uparam:: nType

   *nType* kann einen der folgenden Werte annehmen:

   .. list-table::
      :header-rows: 1

      * - Define
        - Wert
        - Ergebnismatrix
      * - VNUMBER
        - 0
        - Es wird eine Zahlenmatrix erzeugt. Alle Elemente der Eingabematrix die
          keine Zahlen enthalten, werden auf 0 gesetzt.
      * - VSTRING
        - 1
        - Es wird eine Stringmatrix erzeugt. Alle Elemente der Eingabematrix die
          keine Zeichenketten enthalten, werden auf einen String der Länge 0
          gesetzt.
      * - VCOMPLEX
        - 2
        - Es wird eine komplexe Matrix erzeugt. Alle Elemente der Eingabematrix
          die keine komplexen Zahlen enthalten, werden auf den Wert 0+0i
          gesetzt.
      * - VOBJECT
        - 3
        - Es wird eine Variant-Matrix erzeugt. Alle Elemente der Eingabematrix
          die keine UniScript-Objeklte enthalten, werden auf den Wert 0
          gesetzt.
      * - VCOMPOINTER
        - 4
        - Es wird eine Variant-Matrix erzeugt. Alle Elemente der Eingabematrix
          die keine COM-Pointer enthalten, werden auf 0 gesetzt.

   Falls *nType* nicht angegeben wird, wird das erste Element von *vm* verwendet,
   um den Typ der Ausgabematrix fest zu legen.

.. us.example

**Beispiel**

::

   m = [1, "1"];
   vcast(m)
   1.0000 0.0000

.. us.history

**History**

.. list-table::
   :header-rows: 1

   * - Version
     - Beschreibung
   * - 5.30
     - Neu.

.. seealso::
   :ref:`uberblick-programmierung`,
   :ref:`vtype`,
   :ref:`vconvert`,
   :ref:`vmatrix`,
   :ref:`type`

:sub:`id-1169174`