REGEXP_INSTR recherche un motif régulier dans une chaîne. Cette fonction renvoie un entier indiquant la position de début ou de fin de la sous-chaîne recherchée. Si aucune correspondance n'est trouvée, elle renvoie 0.
La fonction évalue les chaînes en utilisant les caractères tels qu'ils sont définis par le jeu de caractères d'entrée.
NUMBER
REGEXP_INSTR (source_char, pattern
[, position
[, occurrence
[, return_option
[, match_parameter ]
]
]
]
)
source_char correspond à l'expression de texte dans laquelle la recherche a lieu.
pattern correspond à la chaîne à rechercher. Un point équivaut à n'importe quel caractère.
position est un entier non nul indiquant l'endroit où la fonction doit commencer la recherche. Si position est un entier négatif, REGEXP_INSTR compte et effectue la recherche à partir de la fin de la chaîne. La valeur de position par défaut est 1, ce qui signifie que la fonction commence la recherche au niveau du premier caractère de la chaîne.
occurrence est un entier indiquant quelle occurrence de pattern la fonction doit rechercher. La valeur d'occurrence doit être positive. La valeur d'occurrence par défaut est 1, ce qui signifie que la fonction recherche la première occurrence de pattern.
return_option est défini sur 0 pour renvoyer la position de la correspondance (valeur par défaut) et sur 1 pour renvoyer la position du caractère suivant cette correspondance.
match_parameter est un littéral de texte qui vous permet de modifier le comportement de la recherche de correspondances par défaut de la fonction. Vous pouvez indiquer les valeurs suivantes :
c : rechercher des correspondances en appliquant le respect maj/min.
i : rechercher des correspondances sans appliquer le respect maj/min.
m : traiter la chaîne source comme si elle comprenait plusieurs lignes. REGEXP_INSTR interprète respectivement ^ et $ comme le début et la fin d'une ligne, quel que soit l'endroit de la chaîne source où ces caractères se trouvent, et pas seulement s'ils figurent au début et à la fin de la chaîne source dans son ensemble. Par défaut, REGEXP_INSTR traite la chaîne source comme une seule ligne.
n : inclure le caractère de retour à la ligne dans les caractères englobés par le point (caractère générique). Par défaut, ce n'est pas le cas.
x : ignorer les caractères non imprimables.
REGEXP_INSTR('Mississippi', 'i', 1, 3) recherche dans la chaîne Mississippi la troisième instance de la lettre i, en commençant la recherche à partir de la première lettre. La valeur renvoyée est 8.
Copyright © 2003, 2007, Oracle. Tous droits réservés.