Substituir primeira ocorrência
Em “one two one three one”, trocar o primeiro “one” por “FIRST” dá “FIRST two one three one”, e as outras ocorrências ficam como estavam. A busca é literal e tem uma opção para ignorar maiúsculas. Grátis no seu navegador.
- Grátis
- Funciona no seu navegador
- Sem cadastro
- Seus dados não saem do seu aparelho
Executar grátis
Exemplo resolvido
- Texto
- one two one three one
- Calcular
- one
- Substituição
- FIRST
- Resultado
- FIRST two one three one
- Texto
- FIRST two one three one
- Original
- one two one three one
- Quantidade
- 1
Editores, engenheiros e pipelines de automação costumam precisar de uma edição precisa: alterar apenas a primeira menção de uma palavra ou token e deixar sozinhas todas as ocorrências posteriores. Um localizar e substituir global reescreve o documento inteiro e pode quebrar exemplos, logs ou nomes de produto que você ainda precisa. Um sinalizador opcional sem distinção de maiúsculas cobre rascunhos mistos em que o primeiro Hello ou HELLO deve mudar sem varrer cada forma posterior. Termos de busca vazios falham com entrada inválida para que trabalhos em lote nunca executem um no-op silencioso.
O que significa substituir a primeira ocorrência e quando usar
Substituir a primeira ocorrência significa percorrer a string de origem da esquerda para a direita, parar na primeira coincidência não sobreposta de um termo de busca, gravar uma string de substituição nesse único lugar e deixar intacta cada coincidência posterior — inclusive quando a substituição está vazia e você só apaga o primeiro achado.
A coincidência é literal: se você busca um ponto ou um parêntese, esses caracteres são texto puro, não sintaxe de expressão regular, de modo que a ferramenta permanece previsível para não desenvolvedores e para pipelines que nunca devem se surpreender com caracteres especiais. Prefira esta calculadora quando a intenção de busca for substituir a primeira ocorrência, trocar só a primeira coincidência, editar a primeira substring ou mudar o primeiro token sem um renome global.
Fontes típicas incluem títulos de documentos em que só o nome de produto inicial deve atualizar, linhas de log em que o primeiro código de erro é reescrito para demos, células CSV com um prefixo legado à esquerda e notas em que um erro de digitação aparece uma vez no topo e corretamente depois. A coincidência opcional sem distinção de maiúsculas dobra o caso das letras para capturar o primeiro Hello, HELLO ou hello sem listar variantes.
Não use este produto quando precisar substituir cada coincidência — isso é uma intenção SEO distinta coberta por ferramentas de localizar e substituir tudo — nem quando precisar de grupos de captura, lookarounds ou motores regex multilinha.
Casos de uso
Somente o primeiro nome de marca ou produto
Atualize o nome de produto inicial em textos de marketing mantendo intactos nomes de exemplo posteriores, SKUs e strings de demonstração.
Limpeza do token inicial em templates
Apague ou reescreva só o primeiro token de placeholder ou prefixo legado em macros, trechos de e-mail e linhas de configuração.
Perguntas frequentes
Como substituo apenas a primeira ocorrência de uma substring?
O replace opcional é a substituição (padrão vazio, que apaga a primeira coincidência). A resposta inclui result, count e index.
O que acontece se o termo de busca estiver vazio?
Uma string find vazia é rejeitada para que pipelines nunca executem um no-op silencioso nem o clássico erro de substituir a string vazia; essas falhas não são cobradas.
Em que isso difere de localizar e substituir tudo?
Esta ferramenta altera só a primeira coincidência e deixa as posteriores intactas. Localizar e substituir tudo troca cada ocorrência. Use replace-first quando precisar de uma edição única e precisa.
A ferramenta de substituir a primeira ocorrência é grátis?
A ferramenta do navegador roda grátis no seu dispositivo.
O find aceita expressões regulares?
Não. O termo de busca é sempre tratado como string literal. Pontos, colchetes e outros metacaracteres de regex coincidem consigo mesmos para que o comportamento permaneça previsível para editores e trabalhos em lote.
Ferramentas relacionadas
Para desenvolvedores — acesso via API
Tudo nesta página está disponível via API. Esta seção é para equipes que querem integrar a ferramenta aos próprios sistemas; quem não precisa disso pode simplesmente usar a ferramenta acima.
Endpoint
Autenticação por token Bearer. Um único POST coloca a tarefa na fila; o resultado chega por webhook ou link assinado.
Chame do seu código
curl -X POST https://api.kit.forhosting.com/str/replace-first \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"text":"one two one three one","find":"one"}'const res = await fetch("https://api.kit.forhosting.com/str/replace-first", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"text": "one two one three one",
"find": "one"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/str/replace-first",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"text": "one two one three one",
"find": "one"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/str/replace-first", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"text":"one two one three one","find":"one"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"text":"one two one three one","find":"one"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/str/replace-first", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Exemplo de requisição
{
"text": "one two one three one",
"find": "one"
}Exemplo de resposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "str.replace_first",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}A API é assíncrona: cada chamada devolve um task_id na hora. Se preferir polling, consulte o status a até 1 requisição por segundo.
Preço
Preço publicado, sem tokens nem créditos escondidos. Tarefa que falha não é cobrada.
Erros
| HTTP | Código | O que significa |
|---|---|---|
401 | unauthorized | Token ausente ou inválido. Confira o header Authorization. |
402 | insufficient_balance | Saldo insuficiente para esta tarefa. Faça uma recarga e tente de novo. |
404 | unknown_type | Esse tipo de tarefa não existe. Confira o campo type no catálogo. |
429 | rate_limited | Muitas requisições em pouco tempo. Espere um instante e tente de novo. |
Notas técnicas
Esta ferramenta de substituir a primeira ocorrência recebe a string de origem, um termo de busca não vazio e uma substituição opcional, troca só a primeira coincidência literal e devolve um contrato JSON estável com o resultado, a contagem de coincidências, o índice de caracteres, o eco do original e os termos aplicados.
O que significa substituir a primeira ocorrência e quando usar
Um termo de busca vazio lança invalid_input, o que protege trabalhos em lote do clássico erro de tratar a string vazia como coincidência entre cada caractere.
Contrato de entrada, rejeição de busca vazia e leitura da resposta
Use só result quando precisar apenas da string limpa; use count e index quando um pipeline registrar se e onde a edição caiu; use original e result juntos quando uma UI de demo precisar mostrar antes e depois. O texto de origem segue as mesmas regras de retenção de outros itens parse do KIT. Envie um corpo JSON com o campo string obrigatório text definido como a fonte que deseja editar e o campo string obrigatório find definido como um termo de busca não vazio. O replace opcional tem como padrão a string vazia, que apaga só a primeira coincidência. case_insensitive opcional tem como padrão false para maiúsculas exatas; defina true quando o primeiro rascunho de maiúsculas mistas ainda deva coincidir. Aliases são aceitos para clientes antigos: text também como input, value, s, content ou source; find como search, needle, from ou old; replace como replacement, with, to ou new; case_insensitive como ignore_case, ci ou insensitive. Text ausente, find ausente, valor que não seja string ou find vazio disparam invalid_input com uma mensagem que nomeia o problema, e essas falhas não são cobradas na API pré-paga. Mantenha payloads em tamanhos de frase, parágrafo e documento curto adequados a um isolate Worker, não em dumps de vários megabytes.
Uso da API, preços, fluxos de trabalho e limites práticos
Chame a ferramenta gratuita no navegador de substituir a primeira ocorrência para limpeza de colagens, demos em sala, QA de conteúdo e renomes rápidos de um único acerto sem instalar utilitário de desktop nem escrever trechos indexOf e slice em cada linguagem. Um fluxo típico renomeia só a primeira menção de marca em um texto de produto para que nomes de exemplo posteriores fiquem intactos, e então verifica se count é um e se index aponta para o deslocamento esperado. Não espere reescrita consciente de HTML que ignore tags, campos de mesclagem de documentos estruturados nem colação específica de locale além da coincidência padrão sem maiúsculas — esses são problemas separados. Autores que enviam SDKs podem documentar text e find como campos obrigatórios e mostrar uma origem com várias coincidências em que só a primeira muda, mais um exemplo de erro de find vazio, para que integradores vejam os dois lados do contrato. Use a API pré-paga do KIT quando um CMS, job ETL, backend de formulários, mesa de suporte ou cliente móvel precisar da mesma transformação sob saldo a US$ 0,002 por item bem-sucedido; falhas de validação nunca consomem saldo após o motor rejeitar a requisição. Outro fluxo apaga um token deprecado inicial enviando replace vazio, ou normaliza a primeira variante de maiúsculas mistas com case_insensitive true antes da indexação de busca. Combine este endpoint com localizar e substituir completo quando um passo posterior realmente precisar de cada coincidência, mas mantenha replace-first como landing própria para não misturar a intenção SEO com ferramentas de substituir tudo.
Casos de integração
QA e fixtures determinísticos
Harnesses de teste fixam saídas golden de replace-first para que um refactor que mude para replace-all ou altere a rejeição de find vazio falhe a integração contínua imediatamente.