.. highlightlang:: us

.. index:: zeros

.. _zeros:

zeros
=====

.. us.tag  zeros ENGLISH math-create-mat

The :ref:`zeros` function creates a real matrix with all elements set to the
value 0.0.

.. function::  rmZeros = zeros(nRows, nColumns)
               rmZeros = zeros(rvSize)

.. us.return

**Return Value**

*rmZeros* is a real matrix with the size *nRows* by *nColumns* with all elements
set to 0.0.

.. us.params

**Parameters**

.. uparam:: nRows

   *nRows* is the number of rows.

.. uparam:: nColumns

   *nColumns* is the number of columns.

.. uparam:: rvSize

   *rvSize* is a vector with two elements. *rvSize[1]* is the number of rows and
   *rvSize[2]* is the number of columns.

.. us.example

**Example**

::

   * m1 = [1,2,3]
   * m1 = [m1, zeros(1, 7)]
   * m2 = zeros(size(m1));

.. seealso::
   :ref:`strempty`,
   :ref:`ones`,
   :ref:`rand`,
   :ref:`size`

:sub:`id-973156`