ForHosting KIT · Ferramentas para dev

Normalizar hifens e travessões

Textos copiados de sites, PDFs, documentos de escritório e sistemas editoriais costumam conter caracteres que parecem traços, mas se comportam de forma diferente em buscas, validações, ordenações e código.

● BetaGrátis · no seu navegador
Use pelo WebAPIE-mailTelegramApp em breve

Este normalizador converte hífens Unicode, meias-riscas, travessões, sinais de menos e variantes relacionadas em um único estilo consistente. Escolha hífen, meia-risca ou travessão e receba o texto limpo com a contagem exata de caracteres alterados.

Por que traços visualmente parecidos causam problemas

O hífen-menos, a meia-risca, o travessão, o sinal matemático de menos e o hífen inseparável podem parecer quase idênticos, principalmente em fontes proporcionais. Para computadores, porém, eles não são equivalentes. Um código de produto copiado de um PDF pode falhar em uma busca exata no banco de dados porque contém um hífen inseparável. Um valor negativo colado de um programa de editoração pode não ser interpretado como número porque usa o sinal matemático de menos, não o caractere ASCII esperado pelo importador. Índices de busca, expressões regulares, detecção de duplicatas, nomes de arquivos e ferramentas de linha de comando também podem tratar esses pontos de código de maneiras diferentes. O problema fica ainda mais difícil de perceber quando o caractere é invisível, como o hífen discricionário usado na quebra de linha. A normalização elimina essa ambiguidade ao trocar os caracteres reconhecidos por um único caractere escolhido. Letras, números, pontuação, espaços e quebras de linha permanecem inalterados; portanto, a operação é precisa e previsível, não uma revisão tipográfica ampla.

Escolha o estilo adequado ao destino

Use o estilo hífen para identificadores, dados importados, intercâmbio de texto simples, chaves de busca, nomes de arquivos, código-fonte e sistemas que esperam ASCII. É a opção mais segura quando compatibilidade importa mais do que tipografia. Escolha a meia-risca para textos editoriais cujo padrão a utilize em intervalos numéricos ou relações, como faixas de páginas e rotas. Escolha o travessão quando o fluxo de publicação exigir pontuação uniforme nas frases. O caractere selecionado substitui todos os traços reconhecidos no texto, inclusive hífens ASCII existentes quando o destino é meia-risca ou travessão. Esse comportamento uniforme é intencional: a ferramenta normaliza caracteres, mas não tenta deduzir se determinada marca representa palavra composta, subtração, intervalo ou comentário intercalado. Essa inferência dependeria do idioma e poderia alterar o sentido silenciosamente. Se o documento precisar de estilos diferentes para funções gramaticais distintas, normalize apenas os trechos relevantes ou aplique regras editoriais contextuais depois desta limpeza mecânica.

Use uma saída determinística em fluxos de limpeza

A resposta inclui o texto normalizado, o estilo escolhido, o caractere de destino literal e a quantidade de caracteres realmente alterados. Um traço que já corresponde ao destino é preservado e não entra na contagem. Isso torna o resultado útil em verificações automáticas de qualidade: um fluxo pode rejeitar tipografia inesperada, registrar quanto do material original mudou ou confirmar que uma segunda normalização relata zero alterações. O algoritmo é determinístico e não usa rede, detecção de idioma, inteligência artificial nem transformação aleatória. Ele percorre uma entrada de tamanho limitado e substitui apenas uma família documentada de caracteres Unicode semelhantes a traços. Os espaços são preservados deliberadamente; um travessão cercado por espaços mantém esses espaços ao virar hífen, e um traço sem espaços continua assim. Dessa forma, a normalização de caracteres não se mistura com uma política subjetiva de espaçamento. Para importações reproduzíveis, execute esta operação antes da tokenização, correspondência exata, leitura numérica, criação de slugs ou remoção de duplicatas e aplique depois as regras específicas de pontuação do seu domínio.

Limpar identificadores importados

Converta hífens inseparáveis ocultos e traços tipográficos antes de comparar códigos de produto, referências de contas ou IDs de documentos.

Preparar texto simples confiável

Padronize a pontuação copiada de PDFs e documentos de escritório antes de usar busca, validação ou processamento de dados.

Aplicar um padrão editorial

Converta traços misturados em uma única meia-risca ou travessão antes de uma revisão de texto direcionada.

Quanto custa?

Você pode executar gratuitamente no navegador nesta página ou pagar US$ 0,002 por solicitação de API.

Quais estilos de saída estão disponíveis?

Você pode normalizar os caracteres reconhecidos para hífen-menos ASCII, meia-risca ou travessão.

A ferramenta muda os espaços ao redor do traço?

Não. Os espaços e as quebras de linha são preservados exatamente; somente os caracteres reconhecidos são substituídos.

Ela decide se o traço é pontuação, intervalo ou subtração?

Não. A normalização é mecânica e não tenta inferir significado gramatical ou matemático.

O que significa a contagem de substituições?

Ela conta os caracteres reconhecidos cujo ponto de código original era diferente do caractere de destino escolhido.

Tudo nesta página está disponível via API. Esta seção é para equipes que querem integrar a ferramenta aos próprios sistemas; quem não precisa disso pode simplesmente usar a ferramenta acima.

POSThttps://api.kit.forhosting.com/str/normalize-dashes

Autenticação por token Bearer. Um único POST coloca a tarefa na fila; o resultado chega por webhook ou link assinado.

curl -X POST https://api.kit.forhosting.com/str/normalize-dashes \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text":"Pages 10–15 — revised − 2 notes"}'
{
  "text": "Pages 10–15 — revised − 2 notes"
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "str.normalize_dashes",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

A API é assíncrona: cada chamada devolve um task_id na hora. Se preferir polling, consulte o status a até 1 requisição por segundo.

por chamadaUS$ 0,002

Preço publicado, sem tokens nem créditos escondidos. Tarefa que falha não é cobrada.

max_chars200000
HTTPCódigoO que significa
401unauthorizedToken ausente ou inválido. Confira o header Authorization.
402insufficient_balanceSaldo insuficiente para esta tarefa. Faça uma recarga e tente de novo.
404unknown_typeEsse tipo de tarefa não existe. Confira o campo type no catálogo.
429rate_limitedMuitas requisições em pouco tempo. Espere um instante e tente de novo.

Ver a documentação completa do KIT →