REGEXP_INSTR

REGEXP_INSTR busca un patrón normal en una cadena. Devuelve un entero que indica la posición inicial o final de la subcadena coincidente. Si no se encuentra ninguna coincidencia, esta función devuelve 0.

Esta función evalúa las cadenas utilizando los caracteres definidos por el juego de caracteres de entrada.

Valor de Retorno

NUMBER

Sintaxis

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

Argumentos

source_char es la expresión de texto en la que se busca.

pattern es la expresión de texto que se busca. El punto coincide con cualquier carácter.

position es un entero que no es cero y que indica dónde inicia la búsqueda la función. Si position es negativa, REGEXP_INSTR empieza la búsqueda contando hacia atrás desde el final de la cadena. El valor por defecto de position es 1, es decir, la función inicia la búsqueda por el primer carácter de la cadena.

occurrence es un entero que indica la incidencia de pattern que debe buscar la función. El valor de occurrence debe ser positivo. El valor por defecto de occurrence es 1, es decir, la función busca la primera incidencia de pattern.

return_option es 0 para volver a la posición de la coincidencia (por defecto) o 1 para volver a la posición del carácter que sigue a la coincidencia.

match_parameter es un literal de texto que permite cambiar el comportamiento de coincidencia por defecto de la función. Puede especificar uno o más de los siguientes valores:

• c: Coincidencia sensible a mayúsculas/minúsculas.

• i: Coincidencia no sensible a mayúsculas/minúsculas.

• m: Trata la cadena de origen como varias líneas. REGEXP_INSTR interpreta ^ y $ como el principio y el final, respectivamente, de cualquier línea de la cadena de origen y no sólo como el principio o el final de la cadena de origen entera. Por defecto, REGEXP_INSTR trata la cadena de origen como una sola línea.

• n: El carácter de nueva línea se incluye entre los caracteres con los que coincide el punto (el carácter comodín). Por defecto, no lo está.

• x: Ignora caracteres de espacio en blanco.

Ejemplo

REGEXP_INSTR('Mississippi', 'i', 1, 3) busca en la cadena Mississippi la tercera instancia de la letra i iniciando la búsqueda por la primera letra. Devuelve el valor 8.

Copyright © 2003, 2007, Oracle. Todos los Derechos Reservados.