Reemplazar primera ocurrencia
En «one two one three one», cambiar el primer «one» por «FIRST» da «FIRST two one three one», y las demás apariciones quedan tal cual. La búsqueda es literal y tiene una opción para ignorar mayúsculas. Gratis en su navegador.
- Gratis
- Funciona en su navegador
- Sin registro
- Sus datos no salen de su equipo
Ejecutar — gratis
Ejemplo resuelto
- Texto
- one two one three one
- Calcular
- one
- Reemplazo
- FIRST
- Resultado
- FIRST two one three one
- Texto
- FIRST two one three one
- Original
- one two one three one
- Cantidad
- 1
Editores, ingenieros y pipelines de automatización suelen necesitar un cambio preciso: modificar solo la primera mención de una palabra o token y dejar solas las ocurrencias posteriores. Un buscar y reemplazar global reescribe todo el documento y puede romper ejemplos, registros o nombres de producto que aún necesita. Un indicador opcional sin distinción de mayúsculas cubre borradores mixtos donde el primer Hello o HELLO debe cambiar sin revisar cada forma posterior. Los términos de búsqueda vacíos fallan con entrada inválida para que los trabajos masivos nunca ejecuten un no-op silencioso.
Qué significa reemplazar la primera ocurrencia y cuándo usarlo
Reemplazar la primera ocurrencia significa recorrer la cadena de origen de izquierda a derecha, detenerse en la primera coincidencia no solapada de un término de búsqueda, escribir una cadena de reemplazo en ese único lugar y dejar intacta cada coincidencia posterior, incluso cuando el reemplazo está vacío y solo se elimina el primer hallazgo.
La coincidencia es literal: si busca un punto o un paréntesis, esos caracteres son texto plano, no sintaxis de expresión regular, de modo que la herramienta permanece predecible para no desarrolladores y para pipelines que no deben sorprenderse con caracteres especiales. Prefiera esta calculadora cuando la intención de búsqueda sea reemplazar la primera ocurrencia, cambiar solo la primera coincidencia, editar la primera subcadena o modificar el primer token sin un renombrado global.
Las fuentes típicas incluyen títulos de documentos donde solo debe actualizarse el nombre de producto inicial, líneas de registro donde se reescribe el primer código de error para demostraciones, celdas CSV con un prefijo legado inicial y notas donde un error ortográfico aparece una vez al inicio y correctamente después. La coincidencia opcional sin distinción de mayúsculas pliega el caso de las letras para capturar el primer Hello, HELLO o hello sin listar variantes.
No use este producto cuando necesite reemplazar cada coincidencia —eso es una intención SEO distinta cubierta por herramientas de buscar y reemplazar todo— ni cuando necesite grupos de captura, lookarounds o motores regex multilínea.
Qué puede hacer con ella
Solo el primer nombre de marca o producto
Actualice el nombre de producto inicial en textos de marketing dejando sin cambios nombres de ejemplo posteriores, SKU y cadenas de demostración.
Limpieza del token inicial en plantillas
Elimine o reescriba solo el primer token de marcador o prefijo legado en macros, fragmentos de correo y líneas de configuración.
Preguntas frecuentes
¿Cómo reemplazo solo la primera ocurrencia de una subcadena?
El replace opcional es la sustitución (por defecto vacío, lo que elimina la primera coincidencia). La respuesta incluye result, count e index.
¿Qué ocurre si el término de búsqueda está vacío?
Una cadena find vacía se rechaza para que los pipelines nunca ejecuten un no-op silencioso ni el clásico pie de cañón de reemplazar la cadena vacía; esos fallos no se cobran.
¿En qué se diferencia de buscar y reemplazar todo?
Esta herramienta cambia solo la primera coincidencia y deja intactas las posteriores. Buscar y reemplazar todo intercambia cada ocurrencia. Use replace-first cuando necesite una edición única y precisa.
¿Es gratuita la herramienta de reemplazar la primera ocurrencia?
La herramienta del navegador se ejecuta gratis en su dispositivo.
¿Find admite expresiones regulares?
No. El término de búsqueda se trata siempre como cadena literal. Puntos, corchetes y otros metacaracteres de regex se coinciden a sí mismos para que el comportamiento sea predecible en editores y trabajos masivos.
Herramientas relacionadas
Para desarrolladores — acceso por API
Todo lo de esta página está disponible por programación. Esta sección es para equipos que quieren integrarlo en sus sistemas; el resto puede usar la herramienta de arriba sin más.
Endpoint de API
¿Prefiere automatizarlo? Un POST autenticado crea la tarea; el resultado llega por webhook o enlace firmado. La misma capacidad también se ejecuta aquí en la web, por email y desde Telegram — y pronto también desde nuestra app.
Llámela desde su stack
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)Ejemplo de solicitud
{
"text": "one two one three one",
"find": "one"
}Ejemplo de respuesta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "str.replace_first",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}La API es asíncrona: la llamada devuelve un task_id al instante y el resultado llega por webhook. El polling está limitado a 1 req/s por tarea.
Precio
Precio publicado — sin tokens ni créditos inventados. Una tarea fallida no se cobra.
Errores
| HTTP | Código | Significado |
|---|---|---|
401 | unauthorized | API key ausente o inválida. |
402 | insufficient_balance | El saldo no cubre el precio de la tarea. |
404 | unknown_type | El tipo de tarea no existe. |
429 | rate_limited | Demasiadas peticiones. Use el webhook en vez de sondear. |
Notas técnicas
Esta herramienta de reemplazar la primera ocurrencia toma su cadena de origen, un término de búsqueda no vacío y un reemplazo opcional, sustituye solo la primera coincidencia literal y devuelve un contrato JSON estable con el resultado, el recuento de coincidencias, el índice de caracteres, el eco del original y los términos aplicados.
Qué significa reemplazar la primera ocurrencia y cuándo usarlo
Un término de búsqueda vacío lanza invalid_input, lo que protege los trabajos masivos del error clásico de tratar la cadena vacía como coincidencia entre cada carácter.
Contrato de entrada, rechazo de búsqueda vacía y lectura de la respuesta
Use solo result cuando necesite la cadena limpia; use count e index cuando un pipeline registre si y dónde aterrizó la edición; use original y result juntos cuando una interfaz de demostración deba mostrar antes y después. El texto de origen sigue las mismas reglas de retención que otros ítems parse del KIT. Envíe un cuerpo JSON con el campo de cadena obligatorio text fijado a la fuente que desea editar y el campo de cadena obligatorio find fijado a un término de búsqueda no vacío. El replace opcional por defecto es la cadena vacía, que elimina solo la primera coincidencia. case_insensitive opcional por defecto es false para mayúsculas exactas; póngalo en true cuando el primer borrador de mayúsculas mixtas deba coincidir igual. Se aceptan alias para clientes antiguos: text también como input, value, s, content o source; find como search, needle, from u old; replace como replacement, with, to o new; case_insensitive como ignore_case, ci o insensitive. Si falta text, falta find, hay un valor no cadena o find es la cadena vacía, se lanza invalid_input con un mensaje que nombra el problema, y esos fallos no se cobran en la API prepago. Mantenga las cargas en tamaños de frase, párrafo y documento corto adecuados a un isolate Worker, no en volcados de varios megabytes.
Uso de la API, precios, flujos de trabajo y límites prácticos
Llame a la herramienta gratuita en el navegador de reemplazar la primera ocurrencia para limpiar pegados, demos de clase, control de calidad de contenido y renombres rápidos de un solo impacto sin instalar una utilidad de escritorio ni escribir fragmentos indexOf y slice en cada lenguaje. Un flujo típico renombra solo la primera mención de marca en un texto de producto para que los nombres de ejemplo posteriores queden intactos, y luego comprueba que count sea uno y que index apunte al desplazamiento esperado. No espere reescritura consciente de HTML que omita etiquetas, campos de fusión de documentos estructurados ni colación específica de locale más allá de la coincidencia estándar sin mayúsculas: esos son problemas distintos. Use la API prepago del KIT cuando un CMS, un trabajo ETL, un backend de formularios, un servicio de soporte o un cliente móvil necesiten la misma transformación bajo saldo a $0.002 por ítem correcto; los fallos de validación nunca consumen saldo tras el rechazo del motor. Otro flujo elimina un token deprecado inicial enviando replace vacío, o normaliza la primera variante de mayúsculas mixtas con case_insensitive true antes de la indexación de búsqueda. Combine este endpoint con un buscar y reemplazar completo cuando un paso posterior necesite de verdad cada coincidencia, pero mantenga replace-first como landing propia para no mezclar la intención SEO con herramientas de reemplazar todo. Los autores que envían SDK pueden documentar text y find como campos obligatorios y mostrar un origen con varias coincidencias donde solo cambia la primera más un ejemplo de error de find vacío para que los integradores vean ambos lados del contrato.
Casos de integración
QA y fixtures deterministas
Los arneses de prueba fijan salidas golden de replace-first para que un refactor que pase a replace-all o cambie el rechazo de find vacío falle la integración continua de inmediato.