Sostituire la prima occorrenza

Questo strumento per sostituire la prima occorrenza prende la stringa di origine, un termine di ricerca non vuoto e una sostituzione opzionale, sostituisce solo la prima corrispondenza letterale e restituisce un contratto JSON stabile con il risultato, il conteggio delle corrispondenze, l’indice di caratteri, l’eco dell’originale e i termini applicati.

Cosa significa sostituire la prima occorrenza e quando usarlo

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

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

Usi solo result quando le serve solo la stringa pulita; usi count e index quando una pipeline registra se e dove è atterrata la modifica; usi original e result insieme quando un’interfaccia demo deve mostrare prima e dopo. Il testo di origine segue le stesse regole di conservazione degli altri elementi parse del KIT. Invii un corpo JSON con il campo stringa obbligatorio text impostato sulla fonte che desidera modificare e il campo stringa obbligatorio find impostato su un termine di ricerca non vuoto. Il replace opzionale ha come predefinito la stringa vuota, che elimina solo la prima corrispondenza. case_insensitive opzionale ha come predefinito false per maiuscole esatte; lo imposti a true quando la prima bozza a maiuscole miste deve comunque corrispondere. Sono accettati alias per client più vecchi: text anche come input, value, s, content o source; find come search, needle, from o old; replace come replacement, with, to o new; case_insensitive come ignore_case, ci o insensitive. Text mancante, find mancante, un valore non stringa o una stringa find vuota sollevano invalid_input con un messaggio che nomina il problema, e tali fallimenti non vengono addebitati sull’API prepagata. Mantenga i payload a dimensioni di frase, paragrafo e documento breve adatte a un isolate Worker piuttosto che dump di più megabyte.

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

Chiami lo strumento gratuito nel browser per sostituire la prima occorrenza per la pulizia di incolli, demo in aula, QA dei contenuti e rinomine rapide a un solo hit senza installare un’utilità desktop né scrivere frammenti indexOf e slice in ogni linguaggio. Un flusso tipico rinomina solo la prima menzione di marca in un testo prodotto così i nomi di esempio successivi restano intatti, poi verifica che count sia uno e che index punti all’offset atteso. Non si aspetti una riscrittura consapevole dell’HTML che salti i tag, campi di unione di documenti strutturati o collazione specifica della locale oltre alla 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 o un client mobile necessitano della stessa trasformazione a saldo a $0.002 per elemento riuscito; i fallimenti di validazione non consumano mai saldo dopo il rifiuto del motore. Un altro flusso elimina un token deprecato iniziale inviando replace vuoto, oppure normalizza la prima variante a maiuscole miste con case_insensitive true prima dell’indicizzazione di ricerca. Abbini questo endpoint a un trova e sostituisci completo quando un passo successivo ha davvero bisogno di ogni corrispondenza, ma mantenga replace-first come landing propria così l’intento SEO non si mescola con gli strumenti di sostituzione totale. Gli autori che spediscono SDK possono documentare text e find come campi obbligatori e mostrare una fonte a più corrispondenze in cui cambia solo il primo hit più un esempio di errore find vuoto, così gli integratori vedono entrambi i lati del contratto.