indexof_regex()

Aplica-se a: ✅Microsoft Fabric✅Azure Data Explorer✅Azure Monitor✅Microsoft Sentinel

Retorna o índice baseado em zero da primeira ocorrência de uma expressão regular de pesquisa especificada dentro da cadeia de caracteres de entrada.

Consulte indexof().

Sintaxe

indexof_regex(Ocorrência de comprimento[,inicial[,de correspondência[,de string,]]])

Saiba mais sobre as convenções de sintaxe.

Parâmetros

Nome	Digitar	Obrigatória	Descrição
cadeia de caracteres	string	✔️	A cadeia de caracteres de origem a ser pesquisada.
match	string	✔️	A cadeia de caracteres de pesquisa de expressão regular.
start	int		A posição inicial da pesquisa. Um valor negativo deslocará a posição inicial da pesquisa do final da cadeia de caracteres por estas várias etapas:abs( start).
length	int		O número de posições de caractere a serem examinadas. Um valor de -1 significa comprimento ilimitado.
occurrence	int		O número da ocorrência. O padrão é 1.

Devoluções

A posição de correspondência do índice com base em zero.

• Retorna -1 se a correspondência não for encontrada na cadeia de caracteres.
• Retorna null se:
  • start é menor que 0.
  • ocorrência é menor que 0.
  • comprimento é menor que -1.

Observação

• Não há suporte para pesquisas de correspondências sobrepostas.
• As cadeias de caracteres de expressão regular podem conter caracteres que exigem escape ou uso @'' de literais de cadeia de caracteres.

Exemplos

Executar a consulta

print
    idx1 = indexof_regex("abcabc", @"a.c"), // lookup found in input string
    idx2 = indexof_regex("abcabcdefg", @"a.c", 0, 9, 2),  // lookup found in input string
    idx3 = indexof_regex("abcabc", @"a.c", 1, -1, 2),  // there's no second occurrence in the search range
    idx4 = indexof_regex("ababaa", @"a.a", 0, -1, 2), // Matches don't overlap so full lookup can't be found 
    idx5 = indexof_regex("abcabc", @"a|ab", -1)  // invalid start argument

Saída

idx1	idx2	idx3	idx4	idx5
0	3	-1	-1