.. highlightlang:: us

.. index:: regex

.. _regex:

regex
=====

.. us.tag  regex NOTREADYGERMAN STR New311 Changed570 Changed5140

:ref:`regex` prüft ob die Elemente eines String-Vektors einem regulären Ausdruck
entsprechen.

.. function::  b = regex(ssRegex, svString)
    b = regex(ssRegex, svString, flags)

.. us.return

**Returnwert**

*b* ist ein Vektor der Länge len(svString). *b[i]* enthält den Wert 1, wenn
*svString[i]* dem regulären Ausdruck *ssRegex* enspricht und sonst den Wert 0.

.. us.params

**Parameter**

.. uparam:: ssRegex

   *ssRegex* ist ein skalarer String mit einem regulärern Ausdruck (siehe 
   Beschreibung unter :ref:`regsplit`).

.. uparam:: svString

   *ssString* ist ein String-Vektor.

.. uparam:: flags

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

      * - REG_ICASE (0x01)
        - 
      * - REG_NEWLINE (0x02)
        - 
      * - REG_NOTBOL (0x04)
        - 
      * - REG_NOTEOL (0x08)
        - 
      * - REG_UTF8 (0x40)
        - 

.. us.example

**Beispiel**

::

   def issym(svSym)
   {
       ssReg = "^[_A-Za-z][_A-Za-z0-9]*$"
       return regex(ssReg, svSym)
   }
   issym(["a", "_a", "1a"])

Das folgende Beispiel liefert den Wert 1, falls ssName mit ``grid`` beginnt
und von 0 oder mehr Ziffern gefolgt ist, z. B. grid, grid1, grid27:

::

   regex("grid[0-9]*$", ssName);

Liefert 1 bei ganzen Zahlen, z. B. -1000  oder +1287 oder 1356

::

   regex("^[-+]?(\d)*$", ssText)

.. us.history

**History**

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

   * - Version
     - Beschreibung
   * - 5.14.0
     - Neue PCRE Version 8.0.
   * - 5.7.0
     - Neuer Parameter *flags*.
   * - 3.1.1
     - Neu.

.. us.comment

**Kommentar**

Lizenz: Siehe :ref:`pcre-license`.

Dokumentation: Siehe unter :ref:`regsplit`

.. seealso::
   :ref:`uberblick-strings`,
   :ref:`regsplit`,
   :ref:`strtok`,
   :ref:`strextract`,
   :ref:`strmatch`,
   :ref:`strmatchi`

:sub:`id-742151`