Erstes Vorkommen ersetzen
In „one two one three one“ ergibt das Ersetzen des ersten „one“ durch „FIRST“ den Text „FIRST two one three one“, alle weiteren Vorkommen bleiben unverändert. Die Suche ist wörtlich, mit einer Option, die Groß- und Kleinschreibung ignoriert. Kostenlos in Ihrem Browser.
- Kostenlos
- Läuft in Ihrem Browser
- Ohne Anmeldung
- Ihre Daten bleiben auf Ihrem Gerät
Im Browser ausführen – kostenlos
Rechenbeispiel
- Text
- one two one three one
- Berechnen
- one
- Ersetzung
- FIRST
- Ergebnis
- FIRST two one three one
- Text
- FIRST two one three one
- Original
- one two one three one
- Anzahl
- 1
Redakteure, Ingenieure und Automatisierungspipelines brauchen oft eine präzise Änderung: nur die erste Erwähnung eines Wortes oder Tokens ändern und jedes spätere Vorkommen unangetastet lassen. Globales Suchen und Ersetzen schreibt das ganze Dokument um und kann Beispiele, Protokolle oder Produktnamen zerstören, die Sie noch brauchen. Ein optionales Groß-/Kleinschreibungs-Flag deckt gemischte Entwürfe ab, in denen das erste Hello oder HELLO wechseln soll, ohne jede spätere Form zu scannen. Leere Suchbegriffe scheitern mit ungültiger Eingabe, damit Massenjobs nie stilles No-Op ausführen.
Was Ersetzen des ersten Vorkommens bedeutet und wann Sie es nutzen
Ersetzen des ersten Vorkommens bedeutet, die Quellzeichenkette von links zu scannen, am ersten nicht überlappenden Treffer eines Suchbegriffs anzuhalten, an genau dieser Stelle eine Ersetzungszeichenkette zu schreiben und jeden späteren Treffer unberührt zu lassen — auch wenn die Ersetzung leer ist und Sie nur den ersten Treffer löschen. Der Abgleich ist wörtlich: suchen Sie nach einem Punkt oder einer Klammer, sind diese Zeichen Klartext, keine reguläre-Ausdrucks-Syntax, sodass das Werkzeug für Nicht-Entwickler und für Pipelines, die bei Sonderzeichen nie überrascht werden dürfen, vorhersehbar bleibt.
Bevorzugen Sie diesen Rechner, wenn die Suchintention Ersetzen des ersten Vorkommens, nur den ersten Treffer tauschen, die erste Teilzeichenkette bearbeiten oder das erste Token ohne globale Umbenennung ändern ist. Typische Quellen sind Dokumenttitel, in denen nur der einleitende Produktname aktualisiert werden soll, Protokollzeilen, in denen der erste Fehlercode für Demos umgeschrieben wird, CSV-Zellen mit führendem Legacy-Präfix und Notizen, in denen ein Tippfehler einmal oben und später korrekt vorkommt. Optionaler groß-/kleinschreibungsunabhängiger Abgleich faltet die Buchstabengröße, sodass das erste Hello, HELLO oder hello ohne Variantenliste erfasst wird.
Nutzen Sie dieses Produkt nicht, wenn Sie jeden Treffer ersetzen müssen — das ist eine andere SEO-Intention, die von Suche-und-Ersetze-alles-Werkzeugen bedient wird — und auch nicht, wenn Sie Fanggruppen, Lookarounds oder mehrzeilige Regex-Engines brauchen.
Typische Einsätze und praktische Grenzen
Rufen Sie das kostenlose Browser-Werkzeug zum Ersetzen des ersten Vorkommens für Einfüge-Bereinigung, Klassendemonstrationen, Inhalts-QA und schnelle Einzeltreffer-Umbenennungen auf, ohne ein Desktop-Dienstprogramm zu installieren oder indexOf-und-slice-Schnipsel in jeder Sprache zu schreiben. Ein typischer Workflow benennt nur die erste Markenerwähnung in einem Produkttext um, damit spätere Beispielnamen intakt bleiben, und prüft dann, dass count eins ist und index auf den erwarteten Offset zeigt.
Kombinieren Sie diesen Endpunkt mit vollständigem Suchen und Ersetzen, wenn ein späterer Schritt wirklich jeden Treffer braucht, behalten Sie replace-first aber als eigene Landing, damit die SEO-Intention nicht mit Ersetze-alles-Werkzeugen vermischt wird. Erwarten Sie keine HTML-bewusste Umschreibung, die Tags überspringt, strukturierte Dokument-Merge-Felder oder locale-spezifische Kollation jenseits des standardmäßigen groß-/kleinschreibungsunabhängigen Abgleichs — das sind getrennte Probleme. Autoren, die SDKs ausliefern, können text und find als Pflichtfelder dokumentieren und eine Mehrtreffer-Quelle zeigen, in der nur der erste Hit wechselt, plus ein leeres-find-Fehlerbeispiel, damit Integratoren beide Seiten des Vertrags sehen.
Anwendungsfälle
Nur erster Marken- oder Produktname
Aktualisieren Sie den einleitenden Produktnamen in Marketingtexten und lassen Sie spätere Beispielnamen, SKUs und Demo-Zeichenketten unverändert.
Bereinigung des führenden Tokens in Vorlagen
Löschen oder überschreiben Sie nur das erste Platzhalter-Token oder Legacy-Präfix in Makros, E-Mail-Schnipseln und Konfigurationszeilen.
Häufige Fragen
Wie ersetze ich nur das erste Vorkommen einer Teilzeichenkette?
Optionales replace ist die Substitution (standardmäßig leer, löscht den ersten Treffer). Die Antwort enthält result, count und index.
Was geschieht, wenn der Suchbegriff leer ist?
Eine leere find-Zeichenkette wird abgelehnt, damit Pipelines nie stilles No-Op oder den klassischen leeren-String-Ersetzungsfehler ausführen; diese Fehler werden nicht berechnet.
Worin unterscheidet sich das von Suchen und Ersetzen alles?
Dieses Werkzeug ändert nur den ersten Treffer und lässt spätere unberührt. Suchen und Ersetzen alles tauscht jedes Vorkommen. Nutzen Sie replace-first, wenn Sie eine präzise Einzelbearbeitung brauchen.
Unterstützt find reguläre Ausdrücke?
Nein. Der Suchbegriff wird immer als wörtliche Zeichenkette behandelt. Punkte, Klammern und andere Regex-Metazeichen matchen sich selbst, damit das Verhalten für Redakteure und Massenjobs vorhersehbar bleibt.
Kann die Suche Groß- und Kleinschreibung ignorieren?
Ja, mit der entsprechenden Option wird das erste Hello, HELLO oder hello ersetzt, egal wie es geschrieben ist. Ohne diese Option achtet die Suche genau auf Groß- und Kleinschreibung.
Verwandte Tools
Für Entwickler — API-Zugang
Alles auf dieser Seite ist auch per API verfügbar. Dieser Abschnitt richtet sich an Teams, die es in ihre eigenen Systeme einbinden möchten; alle anderen nutzen einfach das Tool oben.
Endpunkt
Authentifizierung per Bearer-Token. Ein einziger POST stellt die Aufgabe in die Warteschlange; das Ergebnis erhalten Sie per Webhook oder über einen signierten Link.
Aufruf aus Ihrem 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)Beispiel-Anfrage
{
"text": "one two one three one",
"find": "one"
}Beispiel-Antwort
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "str.replace_first",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}Die API arbeitet asynchron: Sie erhalten sofort eine task_id. Polling ist mit 1 Anfrage pro Sekunde erlaubt.
Preis
Der Preis steht auf der Seite – keine Tokens, keine Credits. Fehlgeschlagene Aufgaben werden nicht berechnet.
Fehler
| HTTP | Code | Bedeutung |
|---|---|---|
401 | unauthorized | Der API-Schlüssel fehlt oder ist ungültig – prüfen Sie den Authorization-Header (Bearer). |
402 | insufficient_balance | Ihr Guthaben reicht für diese Aufgabe nicht aus – Aufladungen verfallen nicht. |
404 | unknown_type | Unbekannter Aufgabentyp – prüfen Sie das Feld „type“ gegen den Katalog. |
429 | rate_limited | Zu viele Anfragen – warten Sie kurz; Polling ist mit 1 Anfrage pro Sekunde erlaubt. |
Technische Hinweise
Dieses Werkzeug zum Ersetzen des ersten Vorkommens nimmt Ihre Quellzeichenkette, einen nicht leeren Suchbegriff und eine optionale Ersetzung, substituiert nur den ersten wörtlichen Treffer und liefert einen stabilen JSON-Vertrag mit Ergebnis, Trefferzahl, Zeichenindex, Original-Echo und den angewandten Begriffen.
Was Ersetzen des ersten Vorkommens bedeutet und wann Sie es nutzen
Ein leerer Suchbegriff wirft invalid_input, was Massenjobs vor dem klassischen Fehler schützt, die leere Zeichenkette als Treffer zwischen jedem Zeichen zu behandeln.
Eingabevertrag, Ablehnung leerer Suche und Lesen der Antwort
Optionales replace ist standardmäßig die leere Zeichenkette und löscht nur den ersten Treffer. Nutzen Sie nur result, wenn Sie nur die bereinigte Zeichenkette brauchen; nutzen Sie count und index, wenn eine Pipeline protokolliert, ob und wo die Bearbeitung landete; nutzen Sie original und result gemeinsam, wenn eine Demo-Oberfläche Vorher-Nachher zeigen muss. Quelltext folgt denselben Aufbewahrungsregeln wie andere KIT-Parse-Elemente. Senden Sie einen JSON-Body mit dem Pflicht-String-Feld text auf die Quelle, die Sie bearbeiten wollen, und dem Pflicht-String-Feld find auf einen nicht leeren Suchbegriff. Optionales case_insensitive ist standardmäßig false für exakte Großschreibung; setzen Sie es auf true, wenn der erste gemischtschreibige Entwurf trotzdem matchen soll. Aliase werden für ältere Clients akzeptiert: text auch als input, value, s, content oder source; find als search, needle, from oder old; replace als replacement, with, to oder new; case_insensitive als ignore_case, ci oder insensitive. Fehlendes text, fehlendes find, ein Nicht-String-Wert oder eine leere find-Zeichenkette werfen invalid_input mit einer Meldung, die das Problem benennt, und diese Fehler werden auf der vorausbezahlten API nicht berechnet. Halten Sie Payloads bei Phrase-, Absatz- und kurzen Dokumentgrößen, die für ein Worker-Isolate geeignet sind, nicht bei Multi-Megabyte-Dumps.
API-Nutzung, Preise, Workflows und praktische Grenzen
Nutzen Sie die vorausbezahlte KIT-API, wenn ein CMS, ETL-Job, Formular-Backend, Support-Desk oder mobiler Client dieselbe Transformation unter Saldo zu $0.002 pro erfolgreichem Element braucht; Validierungsfehler verbrauchen nach Ablehnung durch die Engine nie Saldo. Ein anderer Workflow löscht ein führendes veraltetes Token mit leerem replace oder normalisiert die erste gemischtschreibige Variante mit case_insensitive true vor der Suchindexierung.
Integrationsbeispiele
QA und deterministische Fixtures
Test-Harnesses pinnen replace-first-Golden-Ausgaben, damit Refactors, die auf replace-all umstellen oder die Ablehnung leerer find ändern, die Continuous Integration sofort brechen.
Technische Fragen
Ist das Werkzeug zum Ersetzen des ersten Vorkommens kostenlos?
Das Browser-Werkzeug läuft kostenlos auf Ihrem Gerät. API-Aufrufe nutzen den vorausbezahlten KIT-Saldo zu $0.002 pro erfolgreichem Element; Validierungsfehler werden nicht berechnet.