indexof_regex()indexof_regex()

La funzione restituisce l'indice in base zero della prima occorrenza di una stringa specificata all'interno della stringa di input.Function reports the zero-based index of the first occurrence of a specified string within the input string. Non si sovrappongono le corrispondenze di stringa semplici.Plain string matches don't overlap.

Vedere indexof().See indexof().

SintassiSyntax

indexof_regex(origine , dati ricerca [, start_index [, lunghezza [, occorrenza]]])indexof_regex(source,lookup[,start_index[,length[,occurrence]]])

ArgomentiArguments

ArgomentiArguments DescrizioneDescription Obbligatorio o facoltativoRequired or Optional
sourcesource Stringa di inputInput string NecessarioRequired
lookuplookup Stringa da cercareString to seek NecessarioRequired
start_indexstart_index Posizione iniziale della ricercaSearch start position FacoltativoOptional
lengthlength Numero di posizioni dei caratteri da esaminare.Number of character positions to examine. -1 definisce una lunghezza illimitata-1 defines an unlimited length FacoltativoOptional
occurrenceoccurrence Trovare l'indice dell'aspetto N-esimo del criterio.Find the index of the N-th appearance of the pattern.
Il valore predefinito è 1, ovvero l'indice della prima occorrenzaDefault is 1, the index of the first occurrence FacoltativoOptional

RestituisceReturns

Posizione dell'indice in base zero della ricerca.Zero-based index position of lookup.

  • Restituisce-1 se la stringa non viene trovata nell'input.Returns -1 if the string isn't found in the input.
  • Restituisce null se:Returns null if:
    • start_index è minore di 0.start_index is less than 0.
    • l'occorrenza è minore di 0.occurrence is less than 0.
    • il parametro length è minore di-1.length parameter is less than -1.

EsempioExamples

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 is no second occurrence in the search range
 , idx4 = indexof_regex("ababaa", "a.a", 0, -1, 2)  // Plain string matches do not overlap so full lookup can't be found
 , idx5 = indexof_regex("abcabc", "a|ab", -1)  // invalid input
IDX1idx1 idx2idx2 idx3idx3 idx4idx4 idx5idx5
00 33 -1-1 -1-1