Remplacer la première occurrence

Cet outil de remplacement de la première occurrence prend votre chaîne source, un terme de recherche non vide et un remplacement optionnel, ne substitue que la première correspondance littérale et renvoie un contrat JSON stable avec le résultat, le nombre de correspondances, l’index de caractères, l’écho de l’original et les termes appliqués.

Ce que signifie remplacer la première occurrence et quand l’utiliser

Un terme de recherche vide lève invalid_input, ce qui protège les traitements par lots de l’écueil classique consistant à traiter la chaîne vide comme une correspondance entre chaque caractère.

Contrat d’entrée, rejet de recherche vide et lecture de la réponse

Utilisez result seul lorsque vous n’avez besoin que de la chaîne nettoyée ; utilisez count et index lorsqu’un pipeline journalise si et où l’édition a abouti ; utilisez original et result ensemble lorsqu’une interface de démo doit montrer l’avant et l’après. Le texte source suit les mêmes règles de rétention que les autres éléments parse du KIT. Envoyez un corps JSON avec le champ chaîne obligatoire text défini sur la source que vous souhaitez éditer et le champ chaîne obligatoire find défini sur un terme de recherche non vide. Le replace optionnel vaut par défaut la chaîne vide, qui supprime uniquement la première correspondance. case_insensitive optionnel vaut par défaut false pour une casse exacte ; mettez-le à true lorsque le premier brouillon à casse mixte doit encore correspondre. Des alias sont acceptés pour les anciens clients : text aussi comme input, value, s, content ou source ; find comme search, needle, from ou old ; replace comme replacement, with, to ou new ; case_insensitive comme ignore_case, ci ou insensitive. Un text manquant, un find manquant, une valeur non chaîne ou une chaîne find vide lèvent invalid_input avec un message qui nomme le problème, et ces échecs ne sont pas facturés sur l’API prépayée. Limitez les charges à des tailles de phrase, paragraphe et document court adaptées à un isolate Worker plutôt qu’à des dumps de plusieurs mégaoctets.

Usage API, tarification, flux de travail et limites pratiques

Appelez l’outil gratuit dans le navigateur de remplacement de la première occurrence pour le nettoyage de collages, les démonstrations en classe, le contrôle qualité de contenu et les renommages rapides à un seul impact sans installer un utilitaire de bureau ni écrire des extraits indexOf et slice dans chaque langage. Un flux typique ne renomme que la première mention de marque dans un texte produit afin que les noms d’exemple ultérieurs restent intacts, puis vérifie que count vaut un et que index pointe vers le décalage attendu. Associez ce point de terminaison à un rechercher-remplacer complet lorsqu’une étape ultérieure a vraiment besoin de chaque correspondance, mais gardez replace-first comme page d’atterrissage propre afin de ne pas mélanger l’intention SEO avec les outils de remplacement total. N’attendez pas une réécriture consciente du HTML qui ignore les balises, des champs de fusion de documents structurés ni une collation spécifique à la locale au-delà de la correspondance standard sans casse — ce sont des problèmes distincts. Utilisez l’API prépayée du KIT lorsqu’un CMS, un job ETL, un backend de formulaires, un support ou un client mobile a besoin de la même transformation sous solde à $0.002 par élément réussi ; les échecs de validation ne consomment jamais de solde après le rejet du moteur. Un autre flux supprime un jeton déprécié en tête en envoyant un replace vide, ou normalise la première variante à casse mixte avec case_insensitive true avant l’indexation de recherche. Les auteurs livrant des SDK peuvent documenter text et find comme champs obligatoires et montrer une source à plusieurs correspondances où seul le premier hit change, plus un exemple d’erreur find vide, pour que les intégrateurs voient les deux côtés du contrat.