.. highlightlang:: us

.. index:: sort

.. _sort:

sort
====

.. us.tag  sort GERMAN STR math-base Changed500 Changed532 Changed5502

:ref:`sort` sortiert eine Matrix beliebigen Typs (real, complex, string)
spaltenweise.

.. function::  mSorted = sort(mUnsorted)
               mSorted = sort(mUnsorted, options)

.. us.return

**Returnwert**

*mSorted* ist die sortierte Matrix.

.. us.params

**Parameter**

.. uparam:: mUnsorted

   *mUnsorted* ist die unsortierte Matrix. Die erste Spalte der Matrix wird
   sortiert und die anderen Spalten werden entsprechend vertauscht.

.. uparam:: options

   *options* ist kann folgende Werte oder eine Oder-Verknüpfung folgender Werte
   annehmen:

   .. list-table::
      :header-rows: 0

      * - SORT_REVERT (1)
        - Sortierreihenfolge umdrehen.
      * - SORT_CASE (2)
        - Groß-/Kleinschreibung berücksichtigen (nur bei String-Vektoren/Matrizen).
          Defaultwert: Groß-/Kleinschreibung wird nicht berücksichtigt.

.. us.example

**Beispiel**

::

   * srand("test")
       1.0000
   * a = rand(3,3)
   * a
       0.5536     0.7214     0.6267
       0.0735     0.9892     0.8892
       0.4024     0.0891     0.5894
   * sort(a) // sortiere nach der 1. Spalte
       0.0735     0.9892     0.8892
       0.4024     0.0891     0.5894
       0.5536     0.7214     0.6267
   * // sortiere nach der 2. Spalte
   * a[;2,1,3] = sort(a[;2,1,3])
   * a
       0.4024     0.0891     0.5894
       0.5536     0.7214     0.6267
       0.0735     0.9892     0.8892

.. us.history

**History**

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

   * - Version
     - Beschreibung
   * - R2013.2
     - Verwendet nun Mergesort anstatt Quicksort. Mergesort ist ein
       stabiler Sortieralgorithmus. Bei stabilen Sortierverfahren wird die 
       Reihenfolge von gleichen Elementen im Sortierergebnis erhalten. 
   * - 5.3.2
     - Fehler entfernt. Die Konstanten SORT_REVERT und SORT_CASE waren nicht
       definiert.
   * - 5.0.0
     - Neuer Parameter *options*.

.. seealso::
   :ref:`sorti`,
   :ref:`reshape`

:sub:`id-341140`