.. highlightlang:: us

.. _strmatchi:

strmatchi
=========

.. index:: strmatchi

.. us.tag  strmatchi GERMAN STR New412

:ref:`strmatchi` liefert einen Vektor mit den Indizes der Stringmatrixelemente, die
ein bestimmtes Muster enthalten.

.. function::  rvIndex = strmatchi(ssPattern, smString)

.. us.return

**Returnwert**

*rvIndex* ist ein Vektor mit den Indizes der Elemente der Stringmatrix,
die mit dem Muster übereinstimmen. Falls kein Element mit den Suchmuster
übereinstimmt, liefert die Funktion den Wert 0.

.. us.params

**Parameter**

.. uparam:: ssPattern

   *ssPattern* ist ein skalarer String der
   ein Muster enthält.

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

   * - Wert
     - Bedeutung
   * - \*
     - steht für beliebige Zeichenfolgen (null oder mehr Zeichen).
   * - ?
     - steht für ein beliebiges Zeichen.
   * - [SET]
     - steht für Zeichenfolgen im aufgeführten Satz. Ein SET besteht aus Zeichen oder Zeichen-Bereichen; z. B. [aAbB] oder 0-9A-Z. Um die Bedeutung der Zeichen []\*?!^-\ aufzuheben muss vor das Zeichen ein doppelter Backslash "\\" eingefügt werden.
   * - [!SET] oder [^SET]
     - steht für Zeichenfolgen die nicht im aufgeführten Satz vorhanden sind.

.. uparam:: smString

   *smString* ist eine String-Matrix.

.. us.comment

**Kommentar**

Eine Zeichenfolge besteht aus einzelnen Zeichen oder einem Zeichenbereich. 
Ein Bereich wird durch ein Minuszeichen definiert (wie in 0-9 oder A-Z). 
``[0-9a-zA-Z_]`` definiert den kleinsten erlaubten Satz von Zeichen für einen 
Bereich.

Um die Bedeutung der speziellen Zeichen ``[]*?!^-\`` innerhalb von *Pattern*
zu unterdrücken stellt man vor das entsprechende Zeichen einen doppelten 
Backslash ``\\``.

.. us.example

**Beispiel**

Das folgende Beispiel zeigt, wie festgestellt werden kann, ob in
einer Zeichenkette Kleinbuchstaben verwendet werden.

::

   * strmatchi("*[a-z]*", ["Hallo", "HALLO", "HAllo"])
       1.0000       3.0000

.. seealso::
   :ref:`uberblick-strings`,
   :ref:`strmatch`,
   :ref:`regex`

:sub:`id-447035`