.. highlightlang:: us

.. _strmatch:

strmatch
========

.. index:: strmatch

.. us.tag  strmatch GERMAN STR

:ref:`strmatch` stellt fest, ob die Elemente einer Stringmatrix bestimmte Muster
enthalten.

.. function::  rmBool = strmatch(ssPattern, smString)

.. us.return

**Returnwert**

Die Elemente in *rmBool* sind 1, wenn das Muster
in *ssPattern* mit *smString* übereinstimmt und sonst 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.

::

   * strmatch("*[a-z]*", ["Hallo", "HALLO"])
       1.0000       0.0000

.. us.example

**Beispiel**

::

   * strmatch("hello", "hello")
       1.0000
   * strmatch("hello", "Hello")
       0.0000
   * strmatch("[hH]ello", "Hello")
       1.0000
   * strmatch("*ello", "Hello")
       1.0000
   * strmatch("*el?o", "Hello")
       1.0000
   * what("strm*")
   strmatch
     1 function(s) defined
   * what("str[!m]*")
   strchar
   strCharToOem
   strcode
   strempty
   strfindreplace
   strlen
   strlower
   strOemToChar
   strsplit
   strtod
   strtofield
   strtok
   strtrim
   strupper
     14 function(s) defined
   * strmatch("***CHAN[0-9]***", ["asdf**CHAN1**asdf", "asdf"])
       1.0000    0.0000

.. seealso::
   :ref:`uberblick-strings`,
   :ref:`strmatchi`

:sub:`id-1415657`