.. highlightlang:: us

.. index:: merge

.. _merge:

merge
=====

.. us.tag  merge ENGLISH New300  math-base

:ref:`merge` merges two sorted vectors and returns a single sorted vector.

.. function::  rvMerge = merge(rvA, rvB)

.. us.return

**Return Value**

*rvMerge* is a sorted vector that contains all elements of *rvA* and *rvB*.

.. us.params

**Parameters**

.. uparam:: rvA

   *rvA* is a real column or row vector.

.. uparam:: rvB

   *rvB* is a real column or row vector.

.. us.example

**Example**

::

   * a = [1,2,4,5,5,6]
   * b = [1,3,7]
   * merge(a, b)
     1, 1, 2, 3, 4, 5, 5, 6, 7

.. us.history

**History**

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

   * - Version
     - Description
   * - R2013.2
     - Documentation corrected.
   * - 3.0
     - New.

.. seealso::
   :ref:`overview-mathematic`,
   :ref:`sort`

:sub:`id-73279`