REGEXP_INSTR

REGEXP_INSTR ricerca un pattern regolare in una stringa. Può restituire un numero intero indicante la posizione iniziale o finale della sottostringa corrispondente. Se non viene trovata alcuna corrispondenza, la funzione restituisce 0.

La funzione valuta le stringhe utilizzando i caratteri definiti dal set di caratteri di input.

Valore restituito

NUMBER

Sintassi

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

Argomenti

source_char è l'espressione di testo da ricercare.

pattern è la stringa da cercare. Un punto corrisponde a qualsiasi carattere.

position è un numero intero diverso da zero che indica il punto dal quale la funzione inizia la ricerca. Se position è un valore negativo, REGEXP_INSTR esegue il conteggio e la ricerca a ritroso dalla fine della stringa. Il valore predefinito di position è 1; tale valore indica che la funzione inizia la ricerca dal primo carattere della stringa.

occurrence è un numero intero che indica la ricorrenza di pattern che la funzione deve cercare. Il valore di occurrence deve essere positivo. Il valore predefinito di occurrence è 1; tale valore indica che la funzione cerca la prima ricorrenza di pattern.

return_option può essere uguale a 0 e restituire la posizione della corrispondenza (valore predefinito) oppure uguale a 1 e restituire la posizione del carattere dopo la corrispondenza.

match_parameter è un valore di testo che consente di modificare il funzionamento predefinito della funzione in relazione alle corrispondenze restituite. È possibile specificare uno o più valori tra quelli indicati di seguito.

c: corrispondenza con distinzione tra maiuscole e minuscole.
i: corrispondenza senza distinzione tra maiuscole e minuscole.
m: consente di considerare la stringa di origine come costituita da più righe. REGEXP_INSTR interpreta ^ e $ rispettivamente come l'inizio e la fine di qualsiasi riga in qualsiasi punto della stringa di origine, piuttosto che soltanto all'inizio o alla fine dell'intera stringa di origine. Per impostazione predefinita, REGEXP_INSTR considera la stringa di origine come una riga singola.
n: il carattere di nuova riga è uno di quelli a cui corrisponde un punto (il carattere jolly). Per impostazione predefinita, non corrisponde.
x: ignora gli spazi vuoti.

Esempio

REGEXP_INSTR('Mississippi', 'i', 1, 3) ricerca nella stringa Mississippi la terza istanza della lettera i, iniziando la ricerca dalla prima lettera. Viene restituito il valore 8.