محول UUID إلى عدد صحيح
المعرّف 550e8400-e29b-41d4-a716-446655440000 يساوي العدد الصحيح 113059749145936325402354257176981405696 بطول 128 بتًا: الصق UUID أو عددًا عشريًا أو قيمة ست عشرية لتحصل على الصيغ الثلاث للبتات نفسها مع الإصدار والمتغير. مجاني في متصفحك.
- مجاني
- يعمل في متصفحك
- دون تسجيل
- بياناتك لا تغادر جهازك
شغّل الأداة مجانًا
مثال محلول
- القيمة
- 550e8400-e29b-41d4-a716-446655440000
- UUID (معرّف)
- 550e8400-e29b-41d4-a716-446655440000
- عدد صحيح
- 113059749145936325402354257176981405696
- Hex
- 550e8400e29b41d4a716446655440000
- ستة عشري مع بادئة
- 0x550e8400e29b41d4a716446655440000
معرّف UUID عددٌ من مائة وثمانية وعشرين بتًا يُكتب عادةً اثنين وثلاثين رقمًا ست عشريًا في مجموعات 8-4-4-4-12 بشرطات. وكثيرًا ما تخزّن قواعد البيانات والطوابير والفهارس المضغوطة البتات ذاتها عددًا صحيحًا غير موقّع أو سلسلة hex عارية، ومقارنة تلك الصيغ بالعين مصدر شائع للأخطاء. يقبل محول UUID إلى عدد صحيح هذا UUID بشرطات أو عددًا عشريًا من 128 بتًا أو تمثيلًا ست عشريًا، ثم يعيد الصيغ الثلاث من نمط البتات نفسه. التقابل هو تخطيط RFC 4122 بالترتيب big-endian: تُضمّ البايتات الست عشرة وتُقرأ عددًا صحيحًا غير موقّع من 128 بتًا.
ما العدد الصحيح لـ UUID وكيف تتناظر البتات
تعرّف RFC 4122 وITU-T X.667 معرّف UUID بأنه ستة عشر ثُمانيًا تمامًا. في الإملاء المألوف بالشرطات تظهر تلك الثمانيات اثنين وثلاثين رقمًا ست عشريًا في المجموعات 8-4-4-4-12. قراءة البايتات الست عشرة ذاتها عددًا صحيحًا غير موقّع واحدًا بترتيب الشبكة (big-endian) هو تقابل UUID إلى عدد صحيح الذي يستخدمه هذا المحول ومكتبات شائعة مثل بانٍ integer في uuid.UUID بلغة Python.
الأرقام الثمانية الأولى من hex هي الاثنان والثلاثون بتًا الأعلى أهمية؛ والأرقام الاثنا عشر الأخيرة من hex هي الثمانية والأربعون بتًا الأدنى أهمية. ذلك ليس تخطيط GUID المختلط الإنديان في الذاكرة الذي تستخدمه بعض واجهات Microsoft، حيث تُخزَّن الحقول الثلاثة الأولى بترتيب little-endian: لا تبدّل هذه الأداة تلك الحقول أبدًا، فسلسلة بشرطات تنتج دائمًا العدد الصحيح نفسه الذي تحصلون عليه بضمّ hex وتحليله بالأساس ستة عشر.
تقيم النسخة في النصف العلوي من البايت السابع (الحرف عند فهرس hex اثني عشر) والمتغيّرة في البتات العليا من البايت التاسع (فهرس hex ستة عشر). تُبلَّغ تلك الحقول لتروا إن كانت القيمة UUID وفق RFC 4122 أو شكلًا محجوزًا NCS أو متغيّرة Microsoft أو نمطًا محجوزًا آخر، دون تغيير العدد الصحيح. UUID الصفري هو العدد الصحيح صفر.
وأكبر UUID، اثنان وثلاثون حرفًا f، هو اثنان مرفوعًا إلى مائة وثمانية وعشرين ناقص واحد.
أين يبرّر محول UUID إلى عدد صحيح وجوده
تحتاج المخططات العلائقية التي تخزّن المعرّفات أعدادًا صحيحة غير موقّعة من 128 بتًا أو BINARY(16) إلى طريق حتمي للذهاب والعودة من الصيغة بشرطات التي ينسخها المطوّرون من السجلات. ويمكن لتجهيزات الاختبار والمحمّلات أن تولّد ثلاثيًا قانونيًا — بشرطات وعشري وhex — وتؤكد اتفاق كل عميل لغوي بدل إعادة تنفيذ إزاحات BigInt في كل مستودع. ومن يشرح تخطيط المعرّفات يستطيع تثبيت البتات وإظهار كيف يجلس version وvariant في الكلمة ذاتها من 128 بتًا.
والتحقق الفاشل لا يستهلك الرصيد. أبقوا الطلبات على معرّف واحد، وثبّتوا uuid وinteger وhex في اختباراتكم، فتحصلون على تحويلات قابلة للتكرار للهجرات والتخزين المضغوط والمقارنة عبر الصيغ دون إقامة مكتبة UUID في كل خدمة تنشرونها.
حالات الاستخدام
تخزين مضغوط في قاعدة البيانات وBINARY(16)
حوّلوا UUID بشرطات من سجلات التطبيق إلى العدد الصحيح الدقيق من 128 بتًا أو hex من 32 رقمًا الذي تخزّنه جدولتكم أو عمود BINARY(16).
تجهيزات وأوراكيل اختبار متعددة اللغات
ولّدوا ثلاثيًا قانونيًا uuid / integer / hex وتأكدوا أن كل مكتبة عميل ترمّز البتات ذاتها بترتيب RFC 4122 big-endian.
الأسئلة الشائعة
هل يمكن التحويل بالاتجاه الآخر، من عدد صحيح أو hex إلى UUID؟
نعم. مرّروا سلسلة عدد صحيح عشري أو hex (0x اختياري، حتى 32 رقمًا كحد أقصى). يُعاد نمط البتات نفسه UUID بشرطات وعشريًا وhex.
أهذا تخطيط GUID من Microsoft المختلط الإنديان في الذاكرة؟
لا. العدد الصحيح هو القراءة big-endian للبايتات الست عشرة وفق RFC 4122 / ITU-T X.667. الحقول الثلاثة الأولى بشرطات لا تُبدَّل بايتاتها.
ما العدد الصحيح الذي يقابل المعرّف 550e8400-e29b-41d4-a716-446655440000؟
يقابله العدد 113059749145936325402354257176981405696، وصيغته الست عشرية المضغوطة هي 550e8400e29b41d4a716446655440000. وتبيّن الأداة أيضًا أنه UUID من الإصدار 4 بالمتغير RFC 4122.
لماذا تظهر النتيجة العشرية نصًا لا رقمًا؟
لأن أرقام JavaScript تفقد دقتها فوق اثنين أس 53 ناقص واحد، بينما قد يصل UUID إلى اثنين أس 128 ناقص واحد. وبإرجاع النتيجة نصًا تبقى كل خانة دقيقة ولا يضيع أي بت.
ما أصغر قيمة وأكبر قيمة ممكنة؟
معرّف nil المكوّن من أصفار فقط هو العدد 0. أما الأكبر، المكوّن من 32 حرف f، فيساوي اثنين أس 128 ناقص واحد. ويجب أن يقع أي عدد عشري تدخله بين هذين الحدين.
أدوات ذات صلة
للمطوّرين — الوصول عبر API
كل ما في هذه الصفحة متاح برمجيًا. هذا القسم موجّه للفرق التقنية التي تريد ربط الأداة بأنظمتها الخاصة؛ بقية المستخدمين يمكنهم استخدام الأداة أعلاه مباشرة دون الحاجة لقراءة ما يلي.
الـEndpoint
صادِق على طلبك بترويسة Bearer، وأرسل طلب POST واحدًا لتدخل مهمتك قائمة التنفيذ فورًا؛ ثم تستلم النتيجة عبر webhook أو رابط موقّع.
استدعِ الخدمة من بيئتك
curl -X POST https://api.kit.forhosting.com/dev/uuid-to-integer \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"value":"550e8400-e29b-41d4-a716-446655440000"}'const res = await fetch("https://api.kit.forhosting.com/dev/uuid-to-integer", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"value": "550e8400-e29b-41d4-a716-446655440000"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/dev/uuid-to-integer",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"value": "550e8400-e29b-41d4-a716-446655440000"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/dev/uuid-to-integer", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"value":"550e8400-e29b-41d4-a716-446655440000"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"value":"550e8400-e29b-41d4-a716-446655440000"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/dev/uuid-to-integer", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)مثال على الطلب
{
"value": "550e8400-e29b-41d4-a716-446655440000"
}مثال على الاستجابة
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "dev.uuid_to_integer",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}الواجهة غير متزامنة: تستلم task_id فور الإرسال، ويمكنك الاستعلام عن الحالة بمعدل طلب واحد في الثانية.
الأسعار
السعر معلن كما تراه: لا tokens ولا نظام نقاط؛ وإن فشلت المهمة فلن تُحاسَب عليها.
الأخطاء
| HTTP | الرمز | المعنى |
|---|---|---|
401 | unauthorized | مفتاح الوصول مفقود أو غير صالح؛ تحقق من ترويسة Bearer في طلبك. |
402 | insufficient_balance | رصيدك لا يكفي لتنفيذ هذه المهمة؛ أعد شحن الرصيد ثم أعد المحاولة. |
404 | unknown_type | نوع المهمة المطلوب غير موجود في الكتالوج — راجع الاسم المرسل في الطلب. |
429 | rate_limited | تجاوزت الحد المسموح من الطلبات؛ انتظر قليلًا ثم أعد المحاولة. |
ملاحظات تقنية
تشترك أداة المتصفح المجانية ومسار API في وحدة حتمية واحدة، فلا تختلف هجرات التخزين وتجهيزات الاختبار في بتٍّ واحد.
ما العدد الصحيح لـ UUID وكيف تتناظر البتات
ولأن أعداد JavaScript تفقد الأعداد الصحيحة فوق اثنين مرفوعًا إلى ثلاثة وخمسين ناقص واحد، تُعاد الصيغة العشرية دائمًا سلسلةً دقيقة؛ ويظهر الحقل العددي decimal_number فقط عندما تكون القيمة عددًا صحيحًا آمنًا.
عقد الإدخال والصيغ المقبولة وشكل الاستجابة
الإدخال بشرطات لا يميّز حالة الأحرف ويُعاد دائمًا بأحرف صغيرة قانونية. يجوز أن تحمل الأعداد العشرية الصحيحة علامة زائد بادئة ويجب أن تقع بين صفر واثنين مرفوعًا إلى مائة وثمانية وعشرين ناقص واحد شمولًا. مثال: value 550e8400-e29b-41d4-a716-446655440000 هو UUID وفق RFC 4122 من الإصدار 4 وhex الخاص به 550e8400e29b41d4a716446655440000. أرسلوا جسم JSON بالحقل الإلزامي value: المعرّف بأي إملاء مدعوم. القيمة الاختيارية from تكون auto افتراضيًا ويمكن أن تكون uuid أو integer أو hex عندما تحتاجون إلى فرض التحليل. يفضّل الكشف التلقائي UUID بشرطات، بما في ذلك بادئة اختيارية urn:uuid: أو أقواس معقوفة؛ ثم سلسلة hex ببادئة 0x؛ ثم سلسلة hex مضغوطة من اثنين وثلاثين رقمًا (UUID بلا شرطات)؛ ثم عددًا عشريًا صحيحًا؛ وأخيرًا مقطع hex أقصر مبطّنًا من اليسار إلى اثنين وثلاثين رقمًا. تُقبل الأسماء البديلة uuid وtext وinput وid للحقل value، وformat أو mode للحقل from. تُقبل أعداد JSON فقط عندما تكون أعدادًا صحيحة آمنة؛ ويجب أن تصل قيم 128 بت الأوسع سلاسل حتى لا تُفقد بتات. غياب value والسلاسل الفارغة والأعداد السالبة وأكثر من اثنين وثلاثين رقمًا hex والنص الذي لا يطابق أيًا من الصيغ الثلاث يفشل بـ invalid_input مع تسمية المشكلة، ولا تُفوتر تلك الإخفاقات. عند النجاح يتضمن الجسم uuid (أحرف صغيرة قانونية بشرطات) وinteger (سلسلة عشرية دقيقة) وhex (اثنان وثلاثون رقمًا صغيرًا) وhex_prefixed (الأرقام ذاتها ببادئة 0x) وinput_format (uuid أو integer أو hex) وversion (0–15) وvariant (ncs أو rfc4122 أو microsoft أو reserved) وbit_width 128.
أين يبرّر محول UUID إلى عدد صحيح وجوده
وكثيرًا ما تقارن حافلات الرسائل ومفاتيح المستودع عمود hex مضغوطًا بـ UUID بشرطات من واجهة أصل؛ وتحويل الاثنين إلى العدد الصحيح نفسه (أو hex نفسه من اثنين وثلاثين رقمًا) يتجنّب اختلافات كاذبة بسبب حالة الأحرف أو الأقواس أو بادئة urn:uuid:. ولأن التنفيذ تحليل parse خالص من المستوى A، تكلف كل دعوة ناجحة السعر الأساسي المنشور $0.002 بلا رموز نموذج ولا شبكة صادرة.
حالات التكامل
مقارنة المعرّفات عبر الصيغ
وحّدوا UUID بشرطات وحرفيات hex ذات 0x والمفاتيح العشرية إلى عدد صحيح واحد حتى لا تفشل وصلات المستودع وفروق API بسبب الإملاء.
أسئلة تقنية
كيف نحوّل UUID إلى عدد صحيح من 128 بتًا؟
أرسلوا value كـ UUID بشرطات (اختياري urn:uuid: أو أقواس معقوفة). تعيد API الحقل integer سلسلة عشرية دقيقة مع hex وUUID القانوني بأحرف صغيرة.
لماذا العدد الصحيح سلسلة بدل رقم JSON؟
تتجاوز معظم قيم UUID مدى الأعداد الصحيحة الآمنة في JavaScript (2^53−1). السلسلة العشرية دقيقة دائمًا. يُدرج decimal_number فقط عندما تكون القيمة عددًا صحيحًا آمنًا.
كم تكلفة محول UUID إلى عدد صحيح؟
أداة المتصفح مجانية. تستخدم طلبات API رصيد KIT المدفوع مسبقًا بسعر $0.002 لكل استدعاء ناجح؛ والإدخال غير الصالح لا يُفوتر.