Inserire testo in una posizione esatta

Inserire testo in una posizione aggiunge una stringa esattamente nel punto indicato all’interno di un testo esistente. Fornisca il testo originale, il contenuto da aggiungere e una posizione di carattere con indice iniziale zero; il risultato conserva ogni carattere originale e colloca il nuovo contenuto tra i caratteri ai lati dell’indice. È utile per creare modelli, aggiungere etichette o separatori, correggere contenuti generati ed eseguire modifiche precise in flussi ripetibili. I caratteri Unicode vengono contati in modo coerente, quindi emoji e altri caratteri esterni all’alfabeto latino di base non occupano inaspettatamente due posizioni.

Scelga il punto esatto di inserimento

Le posizioni iniziano da zero: la posizione 0 inserisce prima del primo carattere. La posizione 1 inserisce dopo il primo e prima del secondo, mentre una posizione uguale alla lunghezza originale aggiunge la stringa alla fine. In Hello world, lo spazio è alla posizione 5 e la lettera w alla posizione 6.

Inserendo beautiful alla posizione 6 si ottiene Hello beautiful world. Nulla viene sovrascritto: l’operazione divide l’originale nel confine richiesto, colloca l’inserimento tra le due parti e le riunisce. La regola rende il risultato prevedibile negli script e negli editor visivi.

L’intervallo consentito include entrambi gli estremi, da zero alla lunghezza in caratteri. Una posizione negativa o successiva al confine finale viene rifiutata, non corretta silenziosamente, evitando modifiche nel punto sbagliato. La risposta riporta la posizione applicata e le lunghezze originale, inserita e risultante, così un flusso automatizzato può verificare il cambiamento.

Gestisca in sicurezza il testo Unicode

Questa capacità conta i punti di codice Unicode, non le unità UTF-16 di JavaScript. La distinzione è importante quando il testo contiene emoji, scritture storiche o simboli meno comuni. Un emoji può occupare due unità UTF-16 interne, ma qui viene trattato come una posizione; l’inserimento non ne divide quindi la coppia surrogata e non crea testo danneggiato.

La stessa regola vale per le lunghezze restituite. Segni combinanti e sequenze emoji complesse possono contenere più punti di codice anche quando il carattere tipografico li mostra come un solo gruppo visivo: è una proprietà di Unicode. Se le posizioni provengono da un altro sistema, verifichi che anch’esso conti i punti di codice.

Offset in byte, indici UTF-16 e indici dei grafemi sono coordinate differenti. Rendere esplicita la convenzione evita lievi spostamenti quando i modelli passano tra browser, database e servizi backend e assicura trasformazioni ripetute identiche in ogni ambiente.

Crei modelli e flussi di modifica precisi

L’inserimento esatto diventa potente quando viene composto con altri passaggi. Un flusso documentale può inserire il nome di un account dopo un saluto fisso, aggiungere un identificatore prima dell’estensione di un file o collocare una clausola generata in un confine trovato da un analizzatore. Il testo esistente rimane intatto: diversamente dalla sostituzione, non esiste un termine da cercare né un intervallo da rimuovere.

Usi questa funzione quando il flusso conosce già il confine corretto. Se il contenuto precedente può cambiare, convalidi il confine, perché ogni carattere aggiunto o eliminato prima di esso sposta la posizione. Nei modelli riutilizzabili, marcatori stabili sono spesso più gestibili degli offset fissi; trovi il marcatore e ne invii l’indice.

Una stringa di inserimento vuota è accettata come operazione intenzionalmente neutra e semplifica i flussi condizionali. La funzione è deterministica e non usa rete, casualità o ora corrente: input uguali producono sempre output uguali.