Posição da substring

O que significa achar a posição de uma substring e quando usar

Achar a posição de uma substring significa percorrer a string de origem da esquerda para a direita — ou a partir de um deslocamento start opcional —, parar na primeira coincidência literal não sobreposta de um termo de busca e informar o índice de caracteres desse achado para que um passo posterior recorte, analise ou destaque a partir dali. 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

Quando há coincidência a resposta também inclui position como o índice humano com base um, end como o deslocamento final exclusivo, line e column como coordenadas de editor com base um, e matched como o recorte exato no achado para que uma busca sem maiúsculas ainda mostre a capitalização original. Uma coincidência ausente é um sucesso válido: found é false e index é menos um, o resultado honesto para um haystack que não contém a agulha. Use index com slice quando um script for recortar o restante; use line e column quando uma interface precisar rolar até o achado; use found sozinho quando um portão só precise saber se o marcador existe. Envie um corpo JSON com o campo string obrigatório text definido como a fonte que deseja examinar e o campo string obrigatório find definido como um termo de busca não vazio. O start opcional tem padrão zero e é o índice UTF-16 com base zero onde o percurso começa, de modo que você pode retomar depois de um achado anterior sem reexaminar o prefixo. case_insensitive opcional tem 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, source ou haystack; find como search, needle, substring, query ou pattern; start como from, from_index ou offset; case_insensitive como ignore_case, ci ou insensitive. Text ausente, find ausente, valor que não seja string, start negativo ou não inteiro, 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. O comprimento é limitado a cem mil caracteres para que os percursos do navegador e do Worker fiquem delimitados. Em sucesso a resposta sempre inclui index como o deslocamento de caracteres com base zero ou menos um quando não houver, found como booleano, text e find como aplicados, start e case_insensitive como usados, length e find_length como comprimentos em caracteres, e method sempre igual a index_of.

Uso da API, preços, fluxos de trabalho e limites práticos

Use a API pré-paga do KIT quando um CMS, job ETL, backend de formulários, mesa de suporte, analisador ou cliente móvel precisar do mesmo localizador 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. Combine este endpoint com substituir a primeira quando um passo posterior precisar reescrever só aquele achado, ou com localizar e substituir quando cada coincidência precisar mudar, mas mantenha a posição de substring como landing própria para não misturar a intenção SEO com editores que mutam o texto.