REGEXP_INSTR

REGEXP_INSTR pesquisa uma string para um padrão regular. Pode retornar um número inteiro indicando a posição inicial ou final da substring correspondente. Se nenhuma correspondência for encontrada, a função retornará 0.

A função avalia strings usando caracteres conforme definido pelo conjunto de caracteres de entrada.

Valor de Retorno

NUMBER

Sintaxe

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

Argumentos

source_char é a expressão de texto a ser pesquisada.

pattern é a expressão de texto a ser pesquisada. Um ponto corresponde a qualquer caractere.

posição é um número inteiro diferente de zero indicando onde a função começa a pesquisa. Quando a posição é negativa, REGEXP_INSTR faz a contagem e pesquisa a partir do final da string. o valor default da posição é 1, o que significa que a função começa a pesquisar no primeiro caractere da string.

ocorrência é um número inteiro indicando qual ocorrência do padrão a função deve procurar. O valor da ocorrência deve ser positivo. Os valores default da ocorrência é 1, o que significa que a função procura pela primeira ocorrência do padrão.

return_option é 0 para retornar a posição da correspondência (default), ou 1 para retornar à posição do caractere que segue a correspondência.

match_parameter é um texto que permite alterar o comportamento default de correspondência da função. Você pode especificar um ou mais dos seguintes valores:

c: Distinção entre maiúsculas e minúsculas.
i: Sem distinção entre maiúsculas e minúsculas.
m: Trata a string de origem como várias linhas. REGEXP_INSTR interpreta ^ e $ como o início e o final, respectivamente, de qualquer linha de qualquer lugar da string de origem, em vez de somente no início e no final de toda a string de origem. Por default, REGEXP_INSTR trata a string de origem como uma única linha.
n: o caractere de nova linha está entre os caracteres correspondidos por um ponto (o caractere curinga). Por default, não está.
x: Ignora caracteres de espaço em branco.

Exemplo

REGEXP_INSTR('Mississippi', 'i', 1, 3) procura a string Mississippi para a terceira instância da letra i, começando a pesquisa na primeira letra. Retorna o valor 8.