Posizione sottostringa

Che significa trovare la posizione di una sottostringa e quando usarla

Un termine di ricerca vuoto solleva invalid_input, il che protegge i job di massa dal classico errore di trattare la stringa vuota come corrispondenza tra ogni carattere.

Contratto di ingresso, rifiuto della ricerca vuota e lettura della risposta

Quando una corrispondenza è trovata la risposta include anche position come l’indice umano a base uno, end come lo scostamento finale esclusivo, line e column come coordinate di editor a base uno, e matched come il ritaglio esatto sul risultato così una ricerca senza maiuscole mostra ancora la capitalizzazione originale. Una corrispondenza assente è un successo valido: found è false e index è meno uno, il risultato onesto per un haystack che non contiene l’ago. Usi index con slice quando uno script taglierà il resto; usi line e column quando un’interfaccia deve scorrere fino al risultato; usi found da solo quando un varco deve solo sapere se il marcatore esiste. Invii un corpo JSON con il campo stringa obbligatorio text impostato sulla fonte che desidera esaminare e il campo stringa obbligatorio find impostato su un termine di ricerca non vuoto. Lo start opzionale vale zero per impostazione predefinita ed è l’indice UTF-16 a base zero da cui inizia lo scorrimento, così può riprendere dopo un risultato precedente senza riesaminare il prefisso. case_insensitive opzionale vale false per impostazione predefinita per il caso esatto; lo imposti a true quando la prima bozza a maiuscole miste deve comunque corrispondere. Si accettano alias per client più vecchi: text anche come input, value, s, content, source o haystack; find come search, needle, substring, query o pattern; start come from, from_index o offset; case_insensitive come ignore_case, ci o insensitive. Text assente, find assente, un valore non stringa, uno start negativo o non intero, o una stringa find vuota sollevano invalid_input con un messaggio che nomina il problema, e quei fallimenti non vengono addebitati sull’API prepagata. La lunghezza è limitata a centomila caratteri così gli scorrimenti del browser e del Worker restano delimitati. In caso di successo la risposta include sempre index come lo scostamento di caratteri a base zero o meno uno se non ve n’è, found come booleano, text e find come applicati, start e case_insensitive come usati, length e find_length come lunghezze in caratteri, e method sempre uguale a index_of.

Uso dell’API, prezzi, flussi di lavoro e limiti pratici

Chiami lo strumento gratuito nel browser di posizione della sottostringa per controlli di incolla, dimostrazioni in aula, QA dei contenuti e localizzazione rapida senza installare un’utilità desktop né scrivere frammenti indexOf in ogni linguaggio. Un flusso tipico trova il primo marcatore di sezione, legge index e end, poi ritaglia l’intestazione che segue. Un altro flusso percorre risultati successivi inviando l’end precedente come start successivo, il che individua la seconda occorrenza e le successive senza uno strumento di sostituzione globale. Non si aspetti un salto consapevole dei tag HTML, campi di unione di documenti strutturati, indici di cluster di grafemi o collazione specifica del locale oltre la corrispondenza standard senza maiuscole — sono problemi distinti. Usi l’API prepagata del KIT quando un CMS, un job ETL, un backend di moduli, un desk di supporto, un analizzatore o un client mobile necessitano dello stesso localizzatore a saldo a $0.002 per elemento riuscito; i fallimenti di validazione non consumano mai saldo dopo il rifiuto del motore. Abbini questo endpoint a sostituire la prima quando un passo successivo deve riscrivere solo quel risultato, o a trova e sostituisci quando ogni corrispondenza deve cambiare, ma tenga la posizione della sottostringa come landing propria così l’intento SEO non si mescola con editor che mutano il testo. Gli autori che spediscono SDK possono documentare text e find come campi obbligatori e mostrare una fonte a più corrispondenze in cui viene restituito solo il primo indice più un esempio di errore di find vuoto così gli integrator vedono entrambi i lati del contratto.