Entités HTML nommées → numériques
Passez les entités HTML du nom au numéro et inversement : © devient © et — devient —, pour que le balisage traverse les analyseurs XML et les passerelles de courrier qui ne connaissent pas tous les noms. Gratuit dans votre navigateur.
- Gratuit
- Fonctionne dans votre navigateur
- Sans inscription
- Vos données restent sur votre appareil
Lancer gratuitement
Exemple résolu
- Texte
- Copyright © 2024 — all rights reserved
- Mode de calcul
- To numeric
- Résultat
- Copyright © 2024 — all rights reserved
- Converti
- 2
- Encodage
- entity_named_to_numeric
- Longueur de l'entrée
- 49
Les auteurs HTML et les ingénieurs de pipelines ont souvent besoin du même caractère sous deux formes : une entité nommée comme © ou —, ou une référence numérique de caractère comme © ou —. Les formes nommées se lisent mieux dans le code source ; les formes numériques transitent mieux par les parseurs XML, les clients de messagerie et les processeurs stricts qui n'embarquent pas la table complète des noms HTML. Cette capacité réécrit les entités HTML nommées en leurs références numériques décimales équivalentes, et renvoie les références numériques vers les formes nommées préférées lorsque le point de code est connu. Le chemin est entièrement déterministe : le même texte et le même mode produisent toujours le même résultat, sans appels réseau, sans sels aléatoires et sans raccourcis dépendants de la date.
Entités nommées versus références numériques de caractère
Une entité HTML nommée est un échappement mnémonique tel que © pour le signe de copyright ou — pour le tiret cadratin. Une référence numérique de caractère encode le même scalaire Unicode sous forme décimale © ou hexadécimale ©. Les deux sont valides en HTML ; les formes numériques sont exigées dans certains dialectes XML et préférées lorsque le consommateur peut ne pas connaître tous les noms HTML5.
Cet outil n'encode pas le texte brut en entités et ne décode pas les entités en glyphes visibles pour l'affichage—c'est un autre travail assuré par l'encodeur général d'entités HTML. Ici le contrat est strictement la conversion de format entre références nommées et numériques déjà présentes dans la chaîne. L'entrée hexadécimale est acceptée ; la sortie numérique réussie utilise toujours la forme décimale pour que goldens et diffs restent stables octet par octet.
Les esperluettes nues qui ne forment pas une entité complète terminée par un point-virgule sont laissées intactes, ce qui évite d'exploser les brouillons incomplets tout en attrapant les noms complets mais inconnus tels que ¬anentity;.
Où la conversion nommée vers numérique apporte de la valeur
Les pipelines HTML pour l'e-mail partent souvent d'un contenu CMS rempli de , ’ et — et doivent passer par des passerelles qui ne garantissent que les références numériques. Les sérialiseurs XML et les embarquements SVG préfèrent de même &#N; aux noms absents de XML 1.0. Les ingénieurs qualité figent les deux directions dans des tests de contrat afin qu'un middleware ne change pas silencieusement l'émission de & ou € entre versions.
Les équipes de localisation et d'accessibilité utilisent la même conversion pour auditer que les entités de copyright, de marque et de ponctuation restent cohérentes entre modèles. Les formateurs illustrent la différence entre entités nommées, références décimales et hexadécimales avec un unique oracle déterministe. Associez cette landing à l'encodeur général d'entités HTML lorsque vous devez échapper les esperluettes et chevrons du texte brut, et aux outils de points de code Unicode lorsque vous avez besoin de jetons U+XXXX plutôt que de références HTML.
Intention de recherche distincte, même fiabilité de parse pur que le reste du catalogue d'encodage de niveau A.
Cas d’usage
Normalisation d'entités e-mail et XML
Réécrivez les entités nommées CMS telles que © et — en références numériques décimales avant d'envoyer le HTML via des processeurs e-mail ou XML stricts.
Nettoyage numérique lisible pour les éditeurs
Convertissez les dumps hérités © et — en entités nommées lisibles pour les éditeurs humains et les revues de modèles.
Questions fréquentes
Quelle est la différence avec un encodeur général d'entités HTML ?
Un encodeur général transforme les caractères spéciaux en entités et décode les entités en glyphes. Cet outil ne réécrit que les références nommées en numériques (et l'inverse) sans échapper le texte hors entité.
Que se passe-t-il si une entité nommée est inconnue ?
Rien n'est réécrit et l'appel n'est pas facturé.
Pourquoi convertir des entités nommées en références numériques ?
Parce que les références numériques voyagent mieux. Les analyseurs XML, certains logiciels de messagerie et les traitements stricts n'embarquent pas toute la table des noms HTML, et certains dialectes XML exigent des numéros, alors que © est compris partout comme le signe copyright.
Les références hexadécimales comme © sont-elles acceptées ?
Oui, en entrée. Vers les noms, © devient © comme ©. Quand le résultat est numérique, il est toujours écrit en décimal, afin que la sortie reste identique d'une exécution à l'autre.
Que devient une esperluette qui ne fait pas partie d'une entité ?
Elle reste telle quelle. Seules les entités entières terminées par un point-virgule sont converties, donc une esperluette isolée dans un brouillon n'abîme pas le reste du texte.
Outils associés
Pour les développeurs — accès API
Tout sur cette page est disponible par programmation. Cette section s'adresse aux équipes qui veulent l'intégrer à leurs systèmes ; les autres peuvent simplement utiliser l'outil ci-dessus.
Endpoint
Authentification par jeton Bearer : un seul POST met la tâche en file d’attente, et le résultat vous parvient par webhook ou lien signé.
Appeler depuis votre stack
curl -X POST https://api.kit.forhosting.com/enc/entity-named-to-numeric \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"text":"Copyright © 2024 — all rights reserved"}'const res = await fetch("https://api.kit.forhosting.com/enc/entity-named-to-numeric", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"text": "Copyright © 2024 — all rights reserved"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/enc/entity-named-to-numeric",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"text": "Copyright © 2024 — all rights reserved"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/enc/entity-named-to-numeric", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"text":"Copyright © 2024 — all rights reserved"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"text":"Copyright © 2024 — all rights reserved"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/enc/entity-named-to-numeric", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Exemple de requête
{
"text": "Copyright © 2024 — all rights reserved"
}Exemple de réponse
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "enc.entity_named_to_numeric",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}L’API est asynchrone : chaque appel renvoie un task_id immédiatement, puis vous interrogez l’état à raison d’une requête par seconde.
Tarifs
Le prix est publié, sans tokens ni crédits. Une tâche qui échoue n’est pas facturée.
Erreurs
| HTTP | Code | Signification |
|---|---|---|
401 | unauthorized | Clé API absente ou invalide : vérifiez l’en-tête Authorization. |
402 | insufficient_balance | Solde insuffisant : rechargez votre compte pour lancer cette tâche. |
404 | unknown_type | Type de tâche inconnu : vérifiez le champ type de votre requête. |
429 | rate_limited | Trop de requêtes : ralentissez la cadence, puis réessayez. |
Notes techniques
Les noms inconnus sont signalés par une erreur invalid_input afin que les fautes de frappe ne restent jamais silencieusement dans le balisage de production.
Entités nommées versus références numériques de caractère
En mode to_numeric chaque &name; bien formé est recherché dans une table fixe de noms XML, HTML4 et HTML5 largement utilisés, puis réécrit en jeton décimal stable &#N;. En mode to_named chaque &#N; ou &#xH; bien formé est ramené au nom préféré lorsque ce point de code est enregistré, ainsi — devient — et © devient ©.
Contrat d'entrée, modes et signalement des noms inconnus
Envoyez en POST un corps JSON avec le champ chaîne obligatoire text qui contient le fragment à convertir. Les alias input, value, s et html sont acceptés afin que formulaires et clients SDK réutilisent les noms de champs existants. Le mode vaut to_numeric par défaut et peut être fixé à to_named ; les alias op, direction et action mappent sur le même interrupteur. En to_numeric le gestionnaire ne parcourt que les entités nommées, réécrit chaque nom connu en &#codepoint; et, si un nom complet inconnu apparaît, échoue avec invalid_input dont le message liste chaque nom inconnu distinct pour que vous puissiez corriger la source en une seule passe. En to_named le gestionnaire parcourt les références numériques décimales et hexadécimales, réécrit les points de code connus vers leurs noms préférés et laisse les points non mappés en références décimales normalisées, en les comptant dans unmapped_numeric lorsque ce compteur est supérieur à zéro. Les points de code de substitution et les valeurs hors de la plage scalaire Unicode lèvent invalid_input plutôt que d'émettre un UTF-16 cassé. La charge utile de succès inclut toujours result, mode, encoding fixé à entity_named_to_numeric, converted comme nombre de références réécrites, input_length, output_length et unknown_names comme tableau vide en cas de succès. Il n'y a ni réseau, ni Date, ni aléa, de sorte que le chemin gratuit du navigateur et l'API tarifée renvoient le même JSON pour la même entrée. Une validation échouée n'est pas facturée ; les appels réussis coûtent le prix de base publié $0.002 par élément.
Où la conversion nommée vers numérique apporte de la valeur
Les migrations de contenu qui inversent le problème—dumps décimaux hérités que les éditeurs veulent lire comme entités nommées—utilisent le mode to_named pour que les humains éditent © plutôt que ©. Sur cette page le travail s'exécute entièrement dans votre navigateur ; via l'API chaque conversion réussie coûte $0.002, l'entrée invalide n'est pas facturée et rien n'est stocké après la réponse.
Cas d'intégration
Fixtures CI pour la forme des entités
Générez des paires déterministes nommé-vers-numérique et numérique-vers-nommé afin qu'un middleware ne change pas le style d'entité entre versions.
Questions techniques
Comment convertir © et — en forme numérique ?
Envoyez un texte contenant ces entités nommées avec mode to_numeric (la valeur par défaut). L'API renvoie des références décimales telles que © et — plus un compteur converted.
Puis-je reconvertir des entités numériques en noms ?
Oui. Fixez mode à to_named. Les points de code connus deviennent des noms préférés tels que © ; les non mappés restent des références numériques décimales et sont comptés dans unmapped_numeric le cas échéant.
Combien coûte la conversion d'entités HTML nommées vers numériques ?
L'outil navigateur est gratuit. Les requêtes API utilisent le solde prépayé KIT à $0.002 par appel réussi ; l'entrée invalide n'est pas facturée.