Inserir texto em uma posição exata

Inserir texto em uma posição adiciona uma string exatamente onde você indicar dentro de um texto existente. Informe o texto original, o conteúdo a acrescentar e uma posição de caractere baseada em zero; o resultado preserva todos os caracteres originais e coloca o novo conteúdo entre os caracteres de cada lado desse índice. É útil para montar modelos, adicionar rótulos ou separadores, corrigir conteúdo gerado e fazer edições precisas em fluxos repetíveis. Os caracteres Unicode são contados de modo consistente, portanto emojis e outros caracteres fora do alfabeto latino básico não ocupam duas posições inesperadamente.

Escolha o ponto exato de inserção

As posições são baseadas em zero: a posição 0 insere antes do primeiro caractere. A posição 1 insere depois do primeiro e antes do segundo, enquanto uma posição igual ao comprimento do texto original acrescenta a string escolhida no fim. Por exemplo, Hello world tem um espaço na posição 5 e a letra w na posição 6.

Inserir beautiful na posição 6 produz Hello beautiful world. Nada é sobrescrito: a operação divide o original no limite solicitado, coloca a inserção entre as duas partes e as une novamente. Essa definição torna o comportamento previsível em scripts e editores visuais.

Ao selecionar uma posição por programa, lembre-se de que o intervalo permitido inclui as duas extremidades, de zero até o comprimento em caracteres. Uma posição negativa ou além do limite final é rejeitada, em vez de ajustada silenciosamente, evitando uma edição no local errado. A resposta repete a posição aplicada e informa os comprimentos original, inserido e resultante para que um fluxo automatizado possa conferir a alteração.

Trabalhe com segurança com texto Unicode

Esta capacidade conta pontos de código Unicode, e não unidades UTF-16 do JavaScript. A diferença importa quando o texto contém emojis, escritas históricas ou símbolos menos comuns. Um emoji pode ocupar duas unidades UTF-16 internas, mas aqui é tratado como uma posição, portanto a inserção não divide seu par substituto nem cria texto corrompido.

A mesma regra de contagem vale para os comprimentos original, inserido e resultante. Marcas combinantes e sequências complexas de emojis ainda podem conter vários pontos de código, mesmo que a fonte as mostre como um único agrupamento visual; isso é uma propriedade do Unicode. Se as posições vierem de outro sistema, confirme que ele também conta pontos de código.

Deslocamentos em bytes, índices UTF-16 e índices de grafemas são coordenadas diferentes. Manter esse sistema explícito é particularmente importante quando modelos transitam entre navegadores, bancos de dados e serviços de backend, pois evita desvios sutis de posição e faz transformações repetidas produzirem o mesmo resultado em qualquer ambiente.

Monte modelos e fluxos de edição precisos

A inserção exata é uma operação pequena que se torna poderosa quando combinada com outras etapas. Um fluxo de documentos pode inserir o nome de uma conta após uma saudação fixa, adicionar um identificador antes da extensão de um arquivo ou colocar uma cláusula gerada em um limite encontrado por um analisador anterior. Como o texto existente é preservado, esta ferramenta é diferente de uma substituição: não existe termo de busca nem intervalo selecionado a remover.

Ela funciona melhor quando seu fluxo já conhece o limite correto. Valide esse limite quando o conteúdo anterior puder mudar, porque inserir ou excluir caracteres antes dele deslocará a posição adequada. Em modelos reutilizáveis, marcadores estáveis geralmente são mais fáceis de manter do que deslocamentos fixos; após localizar um marcador, o índice pode ser enviado para a inserção.

Texto de inserção vazio é aceito como uma operação deliberada sem efeito, simplificando fluxos condicionais. A função é determinística e não usa rede, aleatoriedade ou horário atual, portanto entradas iguais sempre geram saídas iguais.