Posición de una subcadena

Qué significa hallar la posición de una subcadena y cuándo usarla

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

Cuando hay coincidencia la respuesta también incluye position como el índice humano con base uno, end como el desplazamiento final exclusivo, line y column como coordenadas de editor con base uno, y matched como el recorte exacto en el hallazgo para que una búsqueda sin mayúsculas siga mostrando la capitalización original. Una coincidencia ausente es un éxito válido: found es false e index es menos uno, el resultado honesto para un haystack que no contiene la aguja. Use index con slice cuando un script recorte el resto; use line y column cuando una interfaz deba desplazarse al hallazgo; use found solo cuando una puerta solo deba saber si el marcador existe. Envíe un cuerpo JSON con el campo de cadena obligatorio text fijado a la fuente que desea examinar y el campo de cadena obligatorio find fijado a un término de búsqueda no vacío. El start opcional vale cero por defecto y es el índice UTF-16 con base cero donde comienza el recorrido, de modo que puede reanudar tras un hallazgo previo sin volver a examinar el prefijo. case_insensitive opcional vale false por defecto 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, source o haystack; find como search, needle, substring, query o pattern; start como from, from_index u offset; case_insensitive como ignore_case, ci o insensitive. Si falta text, falta find, hay un valor que no es cadena, un start negativo o no entero, 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. La longitud se limita a cien mil caracteres para que los recorridos del navegador y del Worker queden acotados. En éxito la respuesta siempre incluye index como el desplazamiento de caracteres con base cero o menos uno si no hay ninguno, found como booleano, text y find tal como se aplicaron, start y case_insensitive tal como se usaron, length y find_length como longitudes en caracteres, y method siempre igual a index_of.

Uso de la API, precios, flujos de trabajo y límites prácticos

Llame a la herramienta gratuita en el navegador de posición de subcadena para comprobaciones de pegado, demos de clase, control de calidad de contenido y localización rápida sin instalar una utilidad de escritorio ni escribir fragmentos indexOf en cada lenguaje. Un flujo típico halla el primer marcador de sección, lee index y end y recorta el encabezado que sigue. Otro flujo recorre hallazgos sucesivos enviando el end anterior como el siguiente start, lo que localiza la segunda ocurrencia y las posteriores sin una herramienta de reemplazar todo. No espere omisión consciente de etiquetas HTML, campos de fusión de documentos estructurados, índices de clústeres de grafemas 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, un analizador o un cliente móvil necesiten el mismo localizador bajo saldo a $0.002 por ítem correcto; los fallos de validación nunca consumen saldo tras el rechazo del motor. Combine este endpoint con reemplazar la primera cuando un paso posterior deba reescribir solo ese hallazgo, o con buscar y reemplazar cuando deba cambiar cada coincidencia, pero mantenga la posición de subcadena como landing propia para no mezclar la intención SEO con editores que mutan el texto. Los autores que envían SDK pueden documentar text y find como campos obligatorios y mostrar un origen con varias coincidencias donde solo se devuelve el primer índice más un ejemplo de error de find vacío para que los integradores vean ambos lados del contrato.