Entità HTML nominate → numeriche
Passi le entità HTML dal nome al numero e viceversa: © diventa © e — diventa —, così il markup attraversa parser XML e gateway di posta che non conoscono tutti i nomi, e torna leggibile quando le serve. Gratis nel suo browser.
- Gratis
- Funziona nel suo browser
- Senza registrazione
- I suoi dati restano sul dispositivo
Esegui gratis nel browser
Esempio risolto
- Testo
- Copyright © 2024 — all rights reserved
- Modalità di calcolo
- To numeric
- Risultato
- Copyright © 2024 — all rights reserved
- Convertito
- 2
- Codifica
- entity_named_to_numeric
- Lunghezza dell'input
- 49
Autori HTML e ingegneri di pipeline spesso necessitano dello stesso carattere in due forme: un'entità nominata come © o —, oppure un riferimento numerico di carattere come © o —. Le forme nominate si leggono meglio nel codice sorgente; quelle numeriche transitano meglio attraverso parser XML, client di posta e processori rigorosi che non includono l'intera tabella dei nomi HTML. Questa capacità riscrive le entità HTML nominate nei loro riferimenti numerici decimali equivalenti e riporta i riferimenti numerici alle forme nominate preferite quando il code point è noto. Il percorso è del tutto deterministico: lo stesso testo e la stessa modalità producono sempre lo stesso risultato, senza chiamate di rete, senza sali casuali e senza scorciatoie dipendenti dalla data.
Entità nominate contro riferimenti numerici di carattere
Un'entità HTML nominata è un escape mnemonico come © per il segno di copyright o — per la lineetta em. Un riferimento numerico di carattere codifica lo stesso scalare Unicode in forma decimale © o esadecimale ©. Entrambe sono valide in HTML; le forme numeriche sono richieste in alcuni dialetti XML e preferite quando il consumatore potrebbe non conoscere tutti i nomi HTML5.
Questo strumento non codifica testo semplice grezzo in entità e non decodifica entità in glifi visibili per la visualizzazione: quel lavoro spetta al codificatore generale di entità HTML. Qui il contratto è strettamente la conversione di formato tra riferimenti nominati e numerici già presenti nella stringa. Gli ampersand nudi che non formano un'entità completa terminata da punto e virgola restano intatti, evitando che bozze incomplete esplodano e catturando comunque nomi completi ma sconosciuti come ¬anentity;.
Dove la conversione da nome a numerico crea valore
Le pipeline HTML per l'e-mail partono spesso da contenuti CMS pieni di , ’ e — e devono transitare da gateway che garantiscono solo riferimenti numerici. Serializzatori XML e incorporamenti SVG preferiscono ugualmente &#N; ai nomi assenti da XML 1.0. Gli ingegneri della qualità fissano entrambe le direzioni nei test di contratto così un middleware non può cambiare in silenzio come vengono emessi & o € tra le release.
I team di localizzazione e accessibilità usano la stessa conversione per verificare che entità di copyright, marchio e punteggiatura restino coerenti tra i modelli. I formatori illustrano la differenza tra entità nominate, riferimenti decimali ed esadecimali con un unico oracolo deterministico. Abbini questa landing al codificatore generale di entità HTML quando deve escapare ampersand e parentesi angolari dal testo semplice, e agli strumenti di code point Unicode quando le servono token U+XXXX invece di riferimenti HTML.
Intento di ricerca distinto, stessa affidabilità di parse puro del resto del catalogo di codifica tier A.
Casi d'uso
Normalizzazione entità per e-mail e XML
Riscriva entità nominate del CMS come © e — in riferimenti numerici decimali prima di inviare HTML attraverso processori e-mail o XML rigorosi.
Pulizia numerica leggibile per gli editori
Converta dump legacy © e — di nuovo in entità nominate leggibili per editori umani e revisioni di modelli.
Domande frequenti
Qual è la differenza tra questo strumento e un codificatore generale di entità HTML?
Un codificatore generale trasforma i caratteri speciali in entità e decodifica le entità in glifi. Questo strumento riscrive solo i riferimenti nominati in numerici (e il contrario) senza trasformare in escape il testo che non è entità.
Cosa succede se un'entità nominata è sconosciuta?
Nulla viene riscritto e la chiamata non viene addebitata.
Perché convertire le entità con nome in riferimenti numerici?
Perché i riferimenti numerici viaggiano meglio. I parser XML, alcuni programmi di posta e i processori rigidi non includono l'intera tabella dei nomi HTML, e alcuni dialetti XML richiedono i numeri, mentre © è compreso ovunque come simbolo del copyright.
Sono accettati i riferimenti esadecimali come ©?
Sì, in ingresso. Passando dai numeri ai nomi, © diventa © proprio come ©. Quando il risultato è numerico viene sempre scritto in decimale, così l'output resta identico a ogni esecuzione.
Che fine fa una e commerciale che non fa parte di un'entità?
Resta esattamente com'è. Vengono convertite solo le entità complete che terminano con il punto e virgola, quindi una e commerciale isolata in una bozza non rovina il resto del testo.
Strumenti correlati
Per sviluppatori — accesso via API
Tutto quello che vedi in questa pagina è disponibile anche via API. Questa sezione è per i team che vogliono integrarlo nei propri sistemi; chi non ne ha bisogno può semplicemente usare lo strumento qui sopra.
Endpoint
Autenticazione con Bearer token: un POST mette in coda l'attività e il risultato arriva via webhook o link firmato.
Chiamala dal tuo 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)Esempio di richiesta
{
"text": "Copyright © 2024 — all rights reserved"
}Esempio di risposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "enc.entity_named_to_numeric",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}L'API è asincrona: ricevi subito un task_id e puoi fare polling fino a 1 richiesta al secondo.
Prezzi
Prezzo pubblicato, senza token né crediti. Se l'attività fallisce, non paghi.
Errori
| HTTP | Codice | Significato |
|---|---|---|
401 | unauthorized | Chiave API mancante o non valida: controlla l'header Authorization. |
402 | insufficient_balance | Credito esaurito: ricarica per continuare a eseguire attività. |
404 | unknown_type | Tipo di attività sconosciuto: controlla il campo type della richiesta. |
429 | rate_limited | Troppe richieste in poco tempo: rallenta e riprova tra qualche secondo. |
Note tecniche
I nomi sconosciuti vengono segnalati con un errore invalid_input affinché i refusi non restino silenziosi nel markup di produzione.
Entità nominate contro riferimenti numerici di carattere
In modalità to_numeric ogni &name; ben formato viene cercato in una mappa fissa di nomi XML, HTML4 e HTML5 ampiamente usati e riscritto come token decimale stabile &#N;. In modalità to_named ogni &#N; o &#xH; ben formato viene mappato al nome preferito quando quel code point è registrato, così — diventa — e © diventa ©.
Contratto di ingresso, modalità e segnalazione dei nomi sconosciuti
Invii con POST un corpo JSON con il campo stringa obbligatorio text che contiene il frammento da convertire. Sono accettati gli alias input, value, s e html così form e client SDK riutilizzano i nomi di campo esistenti. La modalità predefinita è to_numeric e può essere impostata su to_named; gli alias op, direction e action mappano sullo stesso interruttore. Code point surrogati e valori fuori dall'intervallo scalare Unicode sollevano invalid_input anziché emettere UTF-16 corrotto. Il payload di successo include sempre result, mode, encoding fissato a entity_named_to_numeric, converted come conteggio dei riferimenti riscritti, input_length, output_length e unknown_names come array vuoto in caso di successo. Non c'è rete, né Date, né casualità, quindi il percorso gratuito del browser e l'API a pagamento restituiscono lo stesso JSON per lo stesso ingresso. La validazione fallita non viene addebitata; le chiamate riuscite costano il prezzo base pubblicato $0.002 per elemento.
Dove la conversione da nome a numerico crea valore
Le migrazioni di contenuto che invertano il problema—dump decimali legacy che gli editori vogliono leggere come entità nominate—usano la modalità to_named affinché le persone editino © invece di ©. In questa pagina il lavoro gira interamente nel Suo browser; tramite l'API ogni conversione riuscita costa $0.002, l'ingresso non valido non viene addebitato e nulla viene memorizzato dopo la risposta.
Casi di integrazione
Fixture CI per la forma delle entità
Generi coppie deterministiche da nome a numerico e da numerico a nome così il middleware non altera lo stile delle entità tra le release.
Domande tecniche
Come converto © e — in forma numerica?
Invii testo con quelle entità nominate con mode to_numeric (il valore predefinito). L'API restituisce riferimenti decimali come © e — più un conteggio converted.
Posso convertire entità numeriche di nuovo in nomi?
Sì. Imposti mode su to_named. I code point noti diventano nomi preferiti come ©; quelli non mappati restano riferimenti numerici decimali e vengono contati in unmapped_numeric quando presente.
Quanto costa la conversione di entità HTML nominate in numeriche?
Lo strumento nel browser è gratuito. Le richieste API usano il saldo prepagato KIT a $0.002 per chiamata riuscita; l'ingresso non valido non viene addebitato.