Contar ocorrências de uma palavra

Conte quantas vezes uma palavra específica aparece em um texto sem incluir por engano seus caracteres dentro de palavras maiores. Este contador de palavras inteiras ajuda redatores a revisar repetições, editores a acompanhar terminologia obrigatória, professores a avaliar trabalhos e desenvolvedores a validar conteúdo gerado. Por padrão, a comparação ignora maiúsculas e minúsculas, portanto Palavra e palavra entram na mesma contagem; um modo opcional permite separá-las. Há suporte a letras e números Unicode, inclusive palavras com apóstrofos internos. O resultado também informa o total de palavras reconhecidas para contextualizar a contagem.

Como funciona a contagem de ocorrências de palavras inteiras

A correspondência de palavras inteiras responde a uma pergunta mais específica e prática do que procurar uma sequência de caracteres. Se o alvo for sol, uma busca por substring também poderá contar sol em console, insolação ou resolver, produzindo um resultado enganoso. Esta ferramenta primeiro separa o texto fornecido em tokens de palavra compatíveis com Unicode e depois compara cada token completo com a palavra solicitada.

Sequências de letras e números formam palavras, e um apóstrofo interno é preservado; assim, contrações e nomes como don't e O'Brien podem ser contados como uma unidade. Espaços, sinais de pontuação, quebras de linha, travessões e outros separadores estabelecem limites. O algoritmo percorre o conteúdo da esquerda para a direita e aumenta o resultado somente quando um token completo é igual ao alvo.

Ele não extrai radicais nem reúne formas gramaticais, portanto editar, edita, editado e edição continuam diferentes. Esse comportamento é proposital: editores e verificações automatizadas normalmente precisam de uma contagem exata e explicável, não de uma estimativa linguística. Entradas idênticas sempre geram saídas idênticas, pois não há rede, valores aleatórios, dicionários externos nem relógio atual.

Como escolher a distinção de caixa e preparar a entrada

Envie text como uma string não vazia e word como exatamente um token. O alvo não pode conter espaços externos, vírgulas, aspas ou várias palavras; rejeitar essas formas ambíguas impede que uma chamada interprete uma contagem de frase como contagem de palavra. Nesse modo, AZUL, Azul e azul correspondem ao alvo azul após a normalização Unicode para minúsculas.

A saída repete o alvo original sem reescrevê-lo, permitindo que interfaces mostrem exatamente o que você solicitou. O texto pode conter vários parágrafos e muita pontuação, até o limite declarado de 100000 caracteres. Um texto válido sem ocorrências retorna count igual a zero; zero é um resultado útil, não um erro.

Antes de automatizar uma regra editorial, teste uma amostra com caixas variadas e uma palavra maior que contenha o alvo para confirmar se o modo escolhido representa sua política.

Como usar o resultado em fluxos de edição e automação

Para uma verificação rápida, cole um rascunho na ferramenta do navegador, informe a palavra-chave e consulte a contagem inteira. A execução no navegador é adequada para textos privados porque a implementação de nível A usa a mesma biblioteca determinística do manipulador do servidor. Um editor pode comparar números antes e depois de uma reescrita, um sistema educacional pode confirmar que uma palavra de vocabulário aparece em um exercício e um teste de modelo pode exigir que a terminologia necessária ocorra pelo menos uma vez.

Não trate uma contagem alta como prova de qualidade: a repetição pode indicar ênfase, conformidade ou escrita pouco natural, conforme o documento. Lembre-se também de que a correspondência exata não reúne plurais, flexões, sinônimos nem frases com outra pontuação. Se sua política aceitar várias formas, chame a capacidade uma vez para cada alvo explícito e combine os resultados em seu aplicativo.

Fixe exemplos representativos de sucesso e erro de validação em testes automatizados para detectar mudanças nas regras de caixa ou nos limites antes que atinjam o conteúdo de produção.