محوّل كيانات HTML العشرية
تصبح Hi هي Hi: يُكتب كل حرف، بما في ذلك المسافات والحروف المشكّلة والرموز التعبيرية، برقم نقطة ترميزه العشري بين &# وفاصلة منقوطة. الصق ABC لتحصل على ABC. وتُرفض الصيغ السداسية عشرية والمسمّاة. مجاني في متصفحك.
- مجاني
- يعمل في متصفحك
- دون تسجيل
- بياناتك لا تغادر جهازك
شغّل الأداة مجانًا
مثال محلول
- النص
- Hi
- وضع الحساب
- Encode
- النتيجة
- Hi
- الترميز
- html_entities_decimal
- طول المُدخَل
- 2
- طول المُخرَج
- 11
يعيد محوّل كيانات HTML العشرية كتابة النص العادي كجدول خالص من مراجع الأحرف الرقمية العشرية مثل A للحرف A، ويعكس الشكل نفسه عندما تلصق الكيانات لتعود إلى يونيكود بسيط. يمر الترميز على كل قيمة قياسية في يونيكود —بما في ذلك المسافات وعلامات الترقيم والحروف المنبّرة والرموز التعبيرية— فيصبح الخرج تسلسلًا متتابعًا من رموز &#أرقام; بلا فواصل. يقبل فك الترميز فقط المراجع العشرية سليمة الشكل التي تنتهي بفاصلة منقوطة، ويرفض الأشكال الست عشرية &#x…; والكيانات المسمّاة مثل &، ويفشل بوضوح أمام الأجزاء الرقمية الناقصة أو الفارغة حتى لا يبقى ترميز تالف في الإنتاج بصمت. المسار حتمي بالكامل: النص نفسه والوضع نفسه ينتجان دائمًا النتيجة نفسها، بلا استدعاءات شبكة ولا أملاح عشوائية ولا اختصارات تعتمد على التاريخ. من الفحوصات البسيطة ترميز Hi إلى Hi وفك ABC إلى ABC.
ما مراجع الأحرف الرقمية HTML العشرية وما الذي يعيده هذا الأداة
مرجع الحرف الرقمي HTML العشري هو هروب نصي بالشكل علامة و، ثم علامة المربع، ثم رقم عشري واحد أو أكثر، ثم فاصلة منقوطة ختامية. الأرقام هي نقطة شفرة يونيكود للحرف المقصود: خمسة وستون هو A اللاتيني الكبير، واثنان وثلاثون هو المسافة، ومليون ومائتان وخمسة وثمانون ألفًا ومائة واثنا عشر هو قياسي تعبيري شائع. بخلاف الكيانات المسمّاة مثل أو €، لا تحتاج NCR العشرية إلى جدول أسماء مشترك وتعمل لأي قيمة قياسية صالحة يقبلها متصفح أو محلّل XML.
وبخلاف الأشكال الست عشرية التي تبدأ بمربع-x، تظل الأشكال العشرية سهلة الكتابة والبحث ب grep والتوليد من حلقات codePointAt في أي لغة. تُرمِّز هذه الصفحة بتكرار القيم القياسية في يونيكود حتى تصبح أزواج البدائل &#N; واحدًا بدل هروبين خاطئين لوحدات UTF-16، ثم تلصق المراجع بلا مسافات ليكون فك الترميز العكسي دقيقًا. تفشل أيضًا الأجزاء الناقصة مثل &#; أو A بلا فاصلة منقوطة.
تُترك علامات و العارية التي لا تكوّن كيانًا كاملًا كما هي حتى لا تُدمَّر المسودات، لكن كل كيان كامل غير عشري يُبلَّغ عنه.
أين تناسب كيانات HTML العشرية الترميز والاختبارات وقابلية التشغيل البيني
يواجه المطوّرون مراجع الأحرف الرقمية العشرية عندما يخزّن تصدير CMS كل حرف رسومي ك &#N;، وعندما تفرض بوابة بريد أو XML نقلًا ASCII فقط لعناوين يونيكود، وعندما تحتاج مجموعة اختبارات نصًا معتمًا يمرّ ذهابًا وإيابًا عبر محلّلات HTML دون الاعتماد على جداول كيانات مسمّاة تختلف بين HTML4 وHTML5. تفكّ فرق الواجهة الأمامية نصًا غنيًا بالكيانات من قواعد قديمة حتى تعرض مكوّنات الواجهة حروفًا ورموزًا تعبيرية حقيقية بدل تسلسلات حرفية من علامة و والمربع.
يولّد مهندسو الجودة أزواج ترميز وفك حتمية لاختبارات العقد حتى لا يبدّل وسيط يدّعي دعم NCR بصمت إلى أشكال ست عشرية أو مسمّاة بين الإصدارات. يستخدم المعلّمون الأداة نفسها عند شرح الفرق بين المراجع العشرية والست عشرية والكيانات المسمّاة التي تقبلها محلّلات HTML الحديثة. اقرنه بمساعد كيانات HTML العام عندما تحتاج فقط إلى تهريب الأحرف الخاصة، وبمسارات ترميز أخرى عند بناء مختبر صغير لأدوات نص مجانية وحتمية.
حالات الاستخدام
نقل يونيكود آمن مع ASCII
رمّز العناوين والتسميات كتيارات &#N; خالصة حتى يمرّ يونيكود عبر قفزات HTML أو XML ذات ASCII فقط دون جداول كيانات مسمّاة.
تنظيف NCR في CMS قديم
فكّ مراجع الأحرف الرقمية العشرية من ترميز مُصدَّر أو حقول قاعدة بيانات إلى يونيكود بسيط لواجهات حديثة.
الأسئلة الشائعة
ما الأحرف التي تُرمَّز؟
يعيد وضع encode كتابة كل قيمة قياسية في يونيكود ك &#N;. تُحوَّل المسافات وعلامات الترقيم والحروف والرموز التعبيرية كلها — لا أحرف HTML الخاصة فقط.
هل النتيجة حتمية؟
نعم. النص نفسه والوضع نفسه ينتجان دائمًا النتيجة نفسها بلا شبكة ولا عشوائية ولا سلوك يعتمد على التاريخ.
هل تُفكّ الكيانات السداسية عشرية أو المسمّاة؟
لا. تقرأ الأداة المراجع العشرية فقط مثل A. أما المرجع السداسي العشري الكامل الذي يبدأ بالرمز &#x، أو المسمّى مثل &، فيُرفض وتذكر الرسالة أيّ مرجع هو.
كيف تُرمَّز الرموز التعبيرية؟
في مرجع واحد يحمل نقطة الترميز كاملة، لا في نصفين. فالأداة تمرّ على أحرف Unicode كاملة، فيصبح الرمز التعبيري &#N; واحدًا ويُفك بدقة إلى أصله.
لماذا أستخدم المراجع العشرية بدل الكيانات المسمّاة؟
لأنها لا تحتاج إلى جدول أسماء وتصلح لأي حرف صالح، وهي سهلة الكتابة والبحث. وتفيد عندما تقبل بوابة بريد أو XML نص ASCII فقط بينما يحتوي النص على حروف مشكّلة أو رموز تعبيرية.
أدوات ذات صلة
للمطوّرين — الوصول عبر API
كل ما في هذه الصفحة متاح برمجيًا. هذا القسم موجّه للفرق التقنية التي تريد ربط الأداة بأنظمتها الخاصة؛ بقية المستخدمين يمكنهم استخدام الأداة أعلاه مباشرة دون الحاجة لقراءة ما يلي.
الـEndpoint
صادِق على طلبك بترويسة Bearer، وأرسل طلب POST واحدًا لتدخل مهمتك قائمة التنفيذ فورًا؛ ثم تستلم النتيجة عبر webhook أو رابط موقّع.
استدعِ الخدمة من بيئتك
curl -X POST https://api.kit.forhosting.com/enc/html-entities-decimal \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"text":"Hi"}'const res = await fetch("https://api.kit.forhosting.com/enc/html-entities-decimal", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"text": "Hi"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/enc/html-entities-decimal",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"text": "Hi"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/enc/html-entities-decimal", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"text":"Hi"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"text":"Hi"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/enc/html-entities-decimal", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)مثال على الطلب
{
"text": "Hi"
}مثال على الاستجابة
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "enc.html_entities_decimal",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}الواجهة غير متزامنة: تستلم task_id فور الإرسال، ويمكنك الاستعلام عن الحالة بمعدل طلب واحد في الثانية.
الأسعار
السعر معلن كما تراه: لا tokens ولا نظام نقاط؛ وإن فشلت المهمة فلن تُحاسَب عليها.
الأخطاء
| HTTP | الرمز | المعنى |
|---|---|---|
401 | unauthorized | مفتاح الوصول مفقود أو غير صالح؛ تحقق من ترويسة Bearer في طلبك. |
402 | insufficient_balance | رصيدك لا يكفي لتنفيذ هذه المهمة؛ أعد شحن الرصيد ثم أعد المحاولة. |
404 | unknown_type | نوع المهمة المطلوب غير موجود في الكتالوج — راجع الاسم المرسل في الطلب. |
429 | rate_limited | تجاوزت الحد المسموح من الطلبات؛ انتظر قليلًا ثم أعد المحاولة. |
ملاحظات تقنية
استخدمه مجانًا في المتصفح لثوابت القوالب وتمارين الكيانات، أو استدعِ واجهة API بسعر $0.002 لكل طلب ناجح عندما تحتاج المسارات إلى تحويلات NCR عشرية قابلة للتكرار في CI وخدمات الخلفية.
ما مراجع الأحرف الرقمية HTML العشرية وما الذي يعيده هذا الأداة
تتضمن استجابة JSON دائمًا result للسلسلة المحوَّلة، وmode يعكس encode أو decode، وencoding ثابتًا على html_entities_decimal، وinput_length وoutput_length لتحققات الحجم، ومصفوفة codepoints من أعداد صحيحة للمستهلكين البرمجيين، وentities_encoded أو entities_decoded لتأكيد عدد القياسيات المعاد كتابتها. لا يخترع Decode جداول كيانات مسمّاة ولا يقبل الأشكال الرقمية الست عشرية: تسلسل &name; أو &#xH; كامل يرفع invalid_input برسالة تسمّي المرجع السيئ. إن احتجت فقط إلى تهريب علامة و والأقواس الزاوية، فاستخدم مرمّز كيانات HTML العام؛ تجيب هذه الصفحة عقد NCR العشري الكامل بمخرجات مستقرة ملائمة للثوابت ومستهلكي API.
كيف يُقرأ النص والوضع وكيف تبقى النتائج قابلة للتكرار
يمشي Encode على السلسلة بتكرار for-of على القيم القياسية، ويقرأ كل نقطة شفرة، ويُصدِر &#codePoint; بلا فاصل ختامي، فتعطي المدخلات الفارغة نتيجة فارغة والحرف الواحد كيانًا واحدًا. تُرفض نقاط الشفرة خارج المدى من صفر إلى 0x10FFFF وقيم البدائل المنفردة حتى لا تنتج ثوابت سيئة UTF-16 غير قانوني. حقل الحمولة المفضّل هو text مع الأسماء البديلة input وvalue وs وhtml حتى تعيد النماذج وسلاسل الاستعلام وعملاء SDK استخدام العقد نفسه دون إعادة تسمية الأعمدة. يكون mode افتراضيًا encode ويقبل decode صراحة؛ تربط الأسماء البديلة op وdirection وaction المفتاح نفسه للنصوص التي تستخدم تلك الأسماء أصلًا. يمسح Decode من اليسار إلى اليمين: عندما يرى علامة و متبوعة بمربع وأرقام عشرية تنتهي بفاصلة منقوطة يُصدِر الحرف المطابق؛ وعندما يرى أشكال hash-x الست عشرية أو كيانات مسمّاة أو سلاسل أرقام فارغة أو فاصلة منقوطة ناقصة بعد الأرقام يرفع invalid_input بدل التخمين. سقف الطول مئة ألف حرف يبقي ذاكرة Worker متوقعة مع تغطية القوالب والمستندات النموذجية ومعظم حافظات اللصق. اقرن التشغيل المجاني في متصفح هذه الصفحة بواجهة API المدفوعة عندما تحتاج إلى نفس التعيين داخل مسار آلي دون إعادة تنفيذ تحليل الكيانات الرقمية بنفسك. تُرجع المدخلات غير الصالحة invalid_input ولا تُحسب، فيبقى التحقق رخيصًا بينما تظل التحويلات الناجحة بسعر عنصر ثابت $0.002.
أين تناسب كيانات HTML العشرية الترميز والاختبارات وقابلية التشغيل البيني
ترمّز خدمات الخلفية التسميات الديناميكية قبل تضمينها في مقتطفات HTML مقيّدة أو في JSON يصبح لاحقًا ترميزًا، فتضمن بقاء كل حرف —بما في ذلك علامات الاقتباس والأقواس الزاوية— بيانات لا بنية. في هذه الصفحة يعمل كل شيء داخل متصفحك؛ وعبر API يكلّف كل استعلام ناجح $0.002، ولا تُحسب التحققات الفاشلة، ولا يُخزَّن شيء بعد إرجاع الاستجابة. هذا الفصل —استكشاف تفاعلي مجاني وAPI مدفوعة مطابقة— يوافق بقية كتالوج KIT من المستوى A ويتيح الانتقال من عرض صفّي إلى مسار آلي دون تغيير النتيجة المرمّزة.
حالات التكامل
ثوابت CI حتمية
ولّد أزواج ترميز وفك قابلة للتكرار لاختبارات الوحدة وملفات golden وفحوصات العقد عبر الخدمات.
أسئلة تقنية
كم تكلفة محوّل كيانات HTML العشرية؟
مجاني في متصفحك على هذه الصفحة. عبر API يكلّف الطلب الناجح $0.002؛ والمدخلات غير الصالحة لا تُحسب.
ما الأوضاع المدعومة؟
mode=encode (الافتراضي) يحوّل النص إلى مراجع أحرف رقمية عشرية. mode=decode يحوّل تسلسلات &#N; سليمة الشكل إلى أحرف.
ماذا يحدث إذا كان المرجع تالفًا؟
يفشل Decode ب invalid_input للأشكال الست عشرية (A) والكيانات المسمّاة (&) والأجزاء الناقصة (&#;) والفاصلة المنقوطة الناقصة ونقاط الشفرة خارج المدى.