.. highlightlang:: us

.. index:: vmatrix

.. _vmatrix:

vmatrix
=======

.. us.tag  vmatrix NOTREADYENGLISH Programming.variant New5300

:ref:`vmatrix` creates a variant matrix. Each element is set to zero.

.. function::  vm = vmatrix(nr, nc)
               vm = vmatrix(rvRowCol)

.. us.return

**Return Value**

*vm* is a variant matrix with the element values to to zero.

.. us.params

**Parameters**

.. uparam:: nr

   *nr* is the number of rows.

.. uparam:: nc

   *nc* is the number of columns.

.. uparam:: rvRowCol

   *rvRowCol* is a vector with two elements. The first element contains the 
   number of rows and the second element the number of columns.

.. us.example

**Example**

::

   v1 = vmatrix(5, 1);
   a = rand(2,3);
   v2 = vmatrix(size(a))

.. us.history

**History**

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

   * - Version
     - Description
   * - 5.30
     - New.

.. seealso::
   :ref:`overview-programming`,
   :ref:`vtype`,
   :ref:`vconvert`,
   :ref:`vcast`,
   :ref:`type`

:sub:`id-445130`