HTML benannt → numerisch
Wechseln Sie HTML-Entitäten zwischen Name und Zahl: © wird zu © und — zu —, damit Ihr Markup XML-Parser und Mail-Gateways passiert, die nicht jeden Namen kennen, und wieder zurück für lesbaren Quelltext. Kostenlos in Ihrem Browser.
- Kostenlos
- Läuft in Ihrem Browser
- Ohne Anmeldung
- Ihre Daten bleiben auf Ihrem Gerät
Im Browser ausführen – kostenlos
Rechenbeispiel
- Text
- Copyright © 2024 — all rights reserved
- Berechnungsmodus
- To numeric
- Ergebnis
- Copyright © 2024 — all rights reserved
- Umgerechnet
- 2
- Kodierung
- entity_named_to_numeric
- Eingabelänge
- 49
HTML-Autoren und Pipeline-Ingenieure benötigen dasselbe Zeichen oft in zwei Schreibweisen: als benannte Entität wie © oder —, oder als numerische Zeichenreferenz wie © oder —. Benannte Formen sind im Quelltext lesbarer; numerische Formen laufen zuverlässiger durch XML-Parser, E-Mail-Clients und strenge Prozessoren, die keine vollständige HTML-Namens-Tabelle mitbringen. Diese Fähigkeit schreibt benannte HTML-Entitäten in ihre äquivalenten dezimalen numerischen Zeichenreferenzen um und schreibt numerische Referenzen zurück in bevorzugte benannte Formen, wenn der Codepunkt bekannt ist. Der Pfad ist vollständig deterministisch: derselbe Text und derselbe Modus ergeben stets dasselbe Ergebnis, ohne Netzwerkanrufe, ohne Zufallssalze und ohne datumsabhängige Abkürzungen.
Benannte Entitäten versus numerische Zeichenreferenzen
Eine benannte HTML-Entität ist eine mnemonische Escape-Sequenz wie © für das Copyright-Zeichen oder — für den Geviertstrich. Eine numerische Zeichenreferenz kodiert denselben Unicode-Skalar als Dezimalform © oder Hexadezimalform ©. Beide sind in HTML gültig; numerische Formen sind in manchen XML-Dialekten vorgeschrieben und bevorzugt, wenn der Verbraucher nicht jeden HTML5-Namen kennt.
Dieses Werkzeug kodiert keinen rohen Klartext in Entitäten und dekodiert Entitäten nicht zu sichtbaren Glyphen für die Anzeige—das erledigt der allgemeine HTML-Entitäten-Encoder. Hier ist der Vertrag strikt die Formatumwandlung zwischen benannten und numerischen Referenzen, die bereits in der Zeichenkette vorkommen. Hexadezimale Eingabe wird akzeptiert; erfolgreiche numerische Ausgabe nutzt stets die Dezimalform, damit Goldens und Diffs bytestabil bleiben.
Bloße Ampersands, die keine vollständige, mit Semikolon endende Entität bilden, bleiben unberührt—unvollständige Entwürfe explodieren nicht, vollständige aber unbekannte Namen wie ¬anentity; werden dennoch erkannt.
Wo die Umwandlung von benannt zu numerisch sich lohnt
HTML-Pipelines für E-Mail starten oft mit CMS-Inhalten voller , ’ und — und müssen durch Gateways, die nur numerische Referenzen garantieren. XML-Serialisierer und SVG-Einbettungen bevorzugen ebenfalls &#N; gegenüber Namen, die nicht zu XML 1.0 gehören. Qualitätssicherung fixiert beide Richtungen in Vertragstests, damit Middleware zwischen Releases nicht still ändert, wie & oder € ausgegeben werden.
Lokalisierungs- und Barrierefreiheitsteams nutzen dieselbe Umwandlung, wenn sie prüfen, dass Copyright-, Marken- und Interpunktions-Entitäten über Vorlagen hinweg konsistent bleiben. Lehrende demonstrieren den Unterschied zwischen benannten Entitäten, Dezimal- und Hex-Referenzen mit einem einzigen deterministischen Orakel. Kombinieren Sie diese Landing mit dem allgemeinen HTML-Entitäten-Encoder, wenn Sie rohe Ampersands und spitze Klammern aus Klartext escapen müssen, und mit Unicode-Codepunkt-Werkzeugen, wenn Sie U+XXXX-Tokens statt HTML-Referenzen brauchen.
Andere Suchintention, dieselbe reine Parse-Zuverlässigkeit wie im übrigen Tier-A-Kodierungskatalog.
Anwendungsfälle
Entitätsnormalisierung für E-Mail und XML
Schreiben Sie benannte CMS-Entitäten wie © und — in dezimale numerische Referenzen um, bevor HTML strenge E-Mail- oder XML-Prozessoren durchläuft.
Leserliche numerische Bereinigung für Redakteure
Wandeln Sie veraltete ©- und —-Dumps wieder in lesbare benannte Entitäten für menschliche Redakteure und Vorlagenprüfungen um.
Häufige Fragen
Worin unterscheidet sich dieses Werkzeug vom allgemeinen HTML-Entitäten-Encoder?
Ein allgemeiner Encoder wandelt Sonderzeichen in Entitäten um und dekodiert Entitäten zu Glyphen. Dieses Werkzeug schreibt nur benannte Referenzen in numerische um (und umgekehrt), ohne Nicht-Entitäts-Text zu escapen.
Was geschieht bei einer unbekannten benannten Entität?
Nichts wird umgeschrieben und der Aufruf wird nicht berechnet.
Warum benannte Entitäten in numerische Referenzen umwandeln?
Weil numerische Referenzen besser durchkommen. XML-Parser, manche Mailprogramme und strenge Verarbeiter kennen nicht die ganze Tabelle der HTML-Namen, und manche XML-Dialekte verlangen Zahlen, während © überall als Copyright-Zeichen verstanden wird.
Werden hexadezimale Referenzen wie © akzeptiert?
Ja, bei der Eingabe. Beim Umwandeln in Namen wird © genauso zu © wie ©. Ist das Ergebnis numerisch, steht es immer dezimal, damit die Ausgabe bei jedem Durchlauf gleich bleibt.
Was passiert mit einem kaufmännischen Und, das zu keiner Entität gehört?
Es bleibt unverändert. Umgewandelt werden nur vollständige Entitäten mit abschließendem Semikolon, ein loses Und-Zeichen in Ihrem Entwurf beschädigt also den restlichen Text nicht.
Verwandte Tools
Für Entwickler — API-Zugang
Alles auf dieser Seite ist auch per API verfügbar. Dieser Abschnitt richtet sich an Teams, die es in ihre eigenen Systeme einbinden möchten; alle anderen nutzen einfach das Tool oben.
Endpunkt
Authentifizierung per Bearer-Token. Ein einziger POST stellt die Aufgabe in die Warteschlange; das Ergebnis erhalten Sie per Webhook oder über einen signierten Link.
Aufruf aus Ihrem 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)Beispiel-Anfrage
{
"text": "Copyright © 2024 — all rights reserved"
}Beispiel-Antwort
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "enc.entity_named_to_numeric",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}Die API arbeitet asynchron: Sie erhalten sofort eine task_id. Polling ist mit 1 Anfrage pro Sekunde erlaubt.
Preis
Der Preis steht auf der Seite – keine Tokens, keine Credits. Fehlgeschlagene Aufgaben werden nicht berechnet.
Fehler
| HTTP | Code | Bedeutung |
|---|---|---|
401 | unauthorized | Der API-Schlüssel fehlt oder ist ungültig – prüfen Sie den Authorization-Header (Bearer). |
402 | insufficient_balance | Ihr Guthaben reicht für diese Aufgabe nicht aus – Aufladungen verfallen nicht. |
404 | unknown_type | Unbekannter Aufgabentyp – prüfen Sie das Feld „type“ gegen den Katalog. |
429 | rate_limited | Zu viele Anfragen – warten Sie kurz; Polling ist mit 1 Anfrage pro Sekunde erlaubt. |
Technische Hinweise
Unbekannte Namen werden mit einem invalid_input-Fehler gemeldet, damit Tippfehler nicht still im Produktions-Markup verbleiben.
Benannte Entitäten versus numerische Zeichenreferenzen
Im Modus to_numeric wird jedes wohlgeformte &name; in einer festen Karte gängiger XML-, HTML4- und weit verbreiteter HTML5-Namen nachgeschlagen und als stabiles dezimales &#N;-Token umgeschrieben. Im Modus to_named wird jedes wohlgeformte &#N; oder &#xH; auf den bevorzugten Namen abgebildet, wenn dieser Codepunkt registriert ist, sodass — zu — und © zu © wird.
Eingabevertrag, Modi und Meldung unbekannter Namen
Senden Sie per POST einen JSON-Körper mit dem Pflicht-Stringfeld text, das das umzuwandelnde Fragment enthält. Die Aliasse input, value, s und html werden akzeptiert, damit Formulare und SDK-Clients bestehende Feldnamen wiederverwenden können. Der Modus ist standardmäßig to_numeric und kann auf to_named gesetzt werden; die Aliasse op, direction und action mappen auf denselben Schalter. Surrogat-Codepunkte und Werte außerhalb des Unicode-Skalar-Bereichs lösen invalid_input aus, statt defektes UTF-16 zu erzeugen. Die Erfolgsnutzlast enthält stets result, mode, encoding fest auf entity_named_to_numeric, converted als Anzahl umgeschriebener Referenzen, input_length, output_length und unknown_names als leeres Array bei Erfolg. Es gibt kein Netzwerk, kein Date und keinen Zufall, sodass der kostenlose Browser-Pfad und die kostenpflichtige API für dieselbe Eingabe identisches JSON liefern. Fehlgeschlagene Validierung wird nicht berechnet; erfolgreiche Aufrufe kosten den veröffentlichten Grundpreis $0.002 pro Element.
Wo die Umwandlung von benannt zu numerisch sich lohnt
Inhaltsmigrationen, die das Problem umkehren—veraltete Dezimal-Dumps, die Redakteure als benannte Entitäten lesen wollen—nutzen den Modus to_named, damit Menschen © statt © bearbeiten. Auf dieser Seite läuft die Arbeit vollständig in Ihrem Browser; über die API kostet jede erfolgreiche Umwandlung $0.002, ungültige Eingabe wird nicht berechnet, und nach der Antwort wird nichts gespeichert.
Integrationsbeispiele
CI-Fixtures für die Entitätsform
Erzeugen Sie deterministische Paare benannt-zu-numerisch und numerisch-zu-benannt, damit Middleware den Entitätsstil zwischen Releases nicht ändert.
Technische Fragen
Wie wandle ich © und — in numerische Form um?
Senden Sie Text mit diesen benannten Entitäten und mode to_numeric (Standard). Die API liefert dezimale Referenzen wie © und — plus einen converted-Zähler.
Kann ich numerische Entitäten wieder in Namen umwandeln?
Ja. Setzen Sie mode auf to_named. Bekannte Codepunkte werden zu bevorzugten Namen wie ©; unmapped Codepunkte bleiben dezimale numerische Referenzen und werden in unmapped_numeric gezählt, falls vorhanden.
Was kostet die Umwandlung benannter HTML-Entitäten in numerische?
Das Browser-Werkzeug ist kostenlos. API-Anfragen nutzen das vorausbezahlte KIT-Guthaben zu $0.002 pro erfolgreichem Aufruf; ungültige Eingabe wird nicht berechnet.