REGEXP_INSTR

REGEXP_INSTR durchsucht eine Zeichenfolge nach einem regelmäßigen Muster. Die Funktion kann eine Ganzzahl zurückgeben, mit der die Anfangs- oder Endposition der übereinstimmenden Teilzeichenfolge angegeben wird. Wenn keine Übereinstimmung gefunden wird, gibt die Funktion 0 zurück.

Die Funktion wertet Zeichenfolgen mit Zeichen wie von dem Eingabezeichensatz definiert aus.

Rückgabewert

NUMBER

Syntax

REGEXP_INSTR (source_char, pattern
              [, position
                 [, occurrence
                    [, return_option
                       [, match_parameter ]
                    ]
                 ]
              ]
             )

Argumente

source_char ist der zu suchende Textausdruck.

pattern ist die Zeichenfolge, nach der gesucht werden muss. Ein Punkt entspricht jedem Zeichen.

position ist eine von Null abweichende Ganzzahl, die angibt, wo die Funktion mit der Suche beginnt. Wenn position negativ ist, zählt und sucht INSTR ab dem Ende der Zeichenfolge rückwärts. Der Standardwert von position ist 1, d.h. die Funktion beginnt die Suche mit dem ersten Zeichen der Zeichenfolge.

occurrence ist eine Ganzzahl, mit der angegeben wird, nach welchem Vorkommen von pattern die Funktion suchen soll. Der Wert von occurrence muss positiv sein. Der Standardwert von occurrence ist 1, d.h. die Funktion sucht nach dem ersten Vorkommen von pattern.

return_option ist entweder 0, um die Position der Übereinstimmung zurückzugeben (Standard), oder 1, um die Position des Zeichens nach der Übereinstimmung zurückzugeben.

match_parameter ist ein Textliteral, mit dem Sie das Standardübereinstimmungsverhalten der Funktion ändern können. Sie können einen oder mehrere der folgenden Werte angeben:

c: Groß-/Kleinschreibung beachten.
iGroß-/Kleinschreibung muss nicht beachtet werden.
m: Behandelt die Quellzeichenfolge als aus mehreren Zeilen bestehend. REGEXP_INSTR interpretiert ^ und $ als Anfang bzw. Ende einer Zeile an beliebiger Stelle in der Quellzeichenfolge und nicht nur am Anfang oder Ende der ganzen Quellzeichenfolge. Standardmäßig behandeltREGEXP_INSTR die Quellzeichenfolge als eine einzelne Zeile.
n: Das Zeilenvorschubzeichen gehört zu den Zeichen, das mit einem Punkt (Platzhalterzeichen) übereinstimmt. Standardmäßig ist dies nicht der Fall.
x: Leerstellen ignorieren

Beispiel

REGEXP_INSTR('Mississippi', 'i', 1, 3) durchsucht die Zeichenfolge Mississippi nach dem dritten Vorkommen des Buchstabens i, wobei die Suche bei dem ersten Buchstaben beginnt. Sie gibt den Wert 8 zurück.