.. highlightlang:: us

.. index:: sorti

.. _sorti:

sorti
=====

.. us.tag  sorti GERMAN STR Changed500 Changed5502

:ref:`sorti` liefert einen Indexvektor der sortierten Matrix. Die Matrix kann vom
Typ real, complex oder string sein.

.. function::  rvSortIndex = sorti(mUnsorted)
               rvSortIndex = sorti(mUnsorted, options)

.. us.return

**Returnwert**

*rvSortIndex* ist ein Vektor mit den Indizes der sortierten Matrix.

.. us.params

**Parameter**

.. uparam:: mUnsorted

   *mUnsorted* ist die unsortierte Matrix. Die erste Spalte der Matrix wird sortiert.

.. uparam:: options

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

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

      * - SORT_REVERT
        - Sortierreihenfolge umdrehen.
      * - SORT_CASE
        - Groß-/Kleinschreibung berücksichtigen (nur bei
          String-Vektoren/Matrizen). Default-mäßig wird die Groß-/Kleinschreibung
          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
   * sorti(a) // sortiere nach der 1. Spalte
       2.0000
       3.0000
       1.0000
   * // sortiere nach der 2. Spalte
   * sorti(a[;2])
       3.0000
       1.0000
       2.0000
   * // sortiere a nach der 3. Spalte
   * a = a[sorti(a[;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 bleibt Reihenfolge von
       gleichen Elementen im Sortierergebnis erhalten.
   * - 5.0.0
     - Neuer Parameter *options*.

.. seealso::
   :ref:`sort`,
   :ref:`reshape`

:sub:`id-1715870`