ForHosting KIT · أدوات المطورين

حاسبة الجمع المشبع

اجمع عددين صحيحين وأبقِ المجموع داخل عرض بت ثابت: جمع 100 + 50 في كلمة بإشارة من 8 بت يعطي 127 بدل الالتفاف إلى عدد سالب، ويظهر المجموع الدقيق 150 بجانبه. مجاني في متصفحك.

مجاني
يعمل في متصفحك
دون تسجيل
بياناتك لا تغادر جهازك

شغّل الأداة مجانًا اطّلع على الـAPI

استخدمها من الويبAPIالبريدTelegramالتطبيق قريبًا

مثال محلول

إذا أدخلت

A: 100
B: 50
البتات: 8

تحصل على

النتيجة: 127
Min: ‎-128
Max: 127
المجموع الدقيق: 150

يجمع الجمع الصحيح المشبع المجموع الرياضي لعددين صحيحين ثم يقيّده بالقيم القصوى التي ما زالت تُمثَّل في كلمة ذات عرض ثابت تختاره، بدل الالتفاف كما تفعل الحسابيات المعيارية ومعظم أنواع الأعداد الصحيحة في الآلة. يحتاج المهندسون الذين يفحصون نوى DSP وصيغ الضرر في الألعاب وقنوات اللون وعدادات السلامة إلى سلوك التقييد هذا مع حد أدنى وأقصى دقيقين وعلامة تشبع واضحة. ويحتاج الطلاب الذين يقارنون فيضان الالتفاف بالتشبع إلى مَرْجِع حتمي لا يخترع نتيجة معيارية. تقبل حاسبة الجمع المشبع للأعداد الصحيحة هذين الحدّين a وb وعرض بت من اثنين إلى أربعة وستين وعلامة signed اختيارية، وتعيد النتيجة المقيَّدة والمجموع الدقيق غير المقيَّد والمدى القابل للتمثيل وما إذا وقع تشبع بفيضان أو نقصان.

معنى الجمع المشبع مقابل فيضان الالتفاف

الجمع الصحيح العادي بعرض ثابت معياري: عندما يخرج المجموع الحقيقي عن الفترة القابلة للتمثيل تلتف نتيجة الآلة بأخذ باقي المجموع على اثنين مرفوعًا إلى العرض، وقد تقفز من قيمة موجبة كبيرة إلى سالبة كبيرة أو من تحت الصفر مباشرة إلى موجبة كبيرة. أما الجمع المشبع فيتبنى سياسة مختلفة يفضّلها كثير من مجموعات تعليمات DSP ومرمزات الوسائط وعدادات السلامة الحرجة: إذا تجاوز المجموع الحقيقي أقصى قيمة قابلة للتمثيل صارت النتيجة ذلك الأقصى؛ وإذا نقص عن الأدنى صارت النتيجة ذلك الأدنى؛ وإلا ساوت النتيجة المجموع الحقيقي. لا يحدث التفاف معياري.

لعرض موقَّع w بت تمتد الفترة المغلقة من سالب اثنين مرفوعًا إلى w ناقص واحد حتى اثنين مرفوعًا إلى w ناقص واحد ناقص واحد — المدى الكلاسيكي لتكملة الاثنين لـ int8 وint16 وint32. لعرض غير موقَّع w تمتد الفترة من صفر حتى اثنين مرفوعًا إلى w ناقص واحد.

تنفّذ هذه الحاسبة ذلك التقييد تمامًا: تكوّن المجموع الصحيح الدقيق لـ a وb بحساب BigInt، وتقارنه بـ min وmax للعرض والعلامة المختارين، وتُصدر النتيجة المقيَّدة مع قيمة منطقية saturated وحقل direction بقيم none أو overflow أو underflow حتى يسجّل المستدعي أو يتفرع دون إعادة حساب الحدود بنفسه.

أين يفيد الجمع المشبع

يستخدم مطورو الأنظمة المدمجة وDSP الجمع المشبع لمحاكاة سلوك من طراز ARM QADD ومراحل خطوط الوسائط ومراكمات النقطة الثابتة دون إقامة محاكي كامل لفحص حسابي واحد. وكثيرًا ما تشبع أدوات اللون والصوت مجاميع القناة أو العينة عند ثمانية أو ستة عشر بتًا عند معاينة أنماط المزج قبل الالتزام بكود التظليل. ويحتاج معلمو تمثيل الحاسوب للأعداد الصحيحة إلى تقابل جنبًا إلى جنب بين الالتفاف المعياري والتشبع بأرقام قابلة للتكرار من int8 إلى int64.

وتستفيد مواقع المحتوى التي تتنافس على حاسبة الجمع المشبع للأعداد الصحيحة من أداة حية يطابق مسار المتصفح المجاني فيها مسار الأتمتة المدفوع بايتًا بايتًا على الوحدة النقية نفسها. التحقق الفاشل لا يستهلك الرصيد. أبقِ الطلبات صغيرة وثبّت result وsaturated في الاختبارات لتحصل على تقييدات قابلة للتكرار للواجبات ومراجع CI وعُقد الحافة دون إعادة اختراع جداول الحساب بعرض ثابت.

حالات الاستخدام

فحوص البرامج الثابتة لـ DSP والنقطة الثابتة

تحقق من الجمع المشبع مقابل حدود int8/int16/int32 عند نمذجة نوى بأسلوب QADD أو مراكمات نقطة ثابتة دون محاكي كامل.

تقييد موارد الألعاب والمحاكاة

قيّد مجاميع الصحة أو الضرر أو النقاط بعرض بت مختار حتى يشبع الفيضان عند الأقصى بدل الالتفاف إلى قيمة سالبة.

الأسئلة الشائعة

كيف يختلف الجمع المشبع للأعداد الصحيحة عن الفيضان العادي؟

الجمع بعرض ثابت العادي يلتف (حساب معياري). الجمع المشبع يقيّد المجموع الحقيقي إلى أدنى أو أقصى قيمة قابلة للتمثيل للعرض والعلامة المختارين ولا يلتف أبدًا.

ماذا يعني saturated وdirection؟

saturated يكون true عندما قُيِّدت النتيجة. direction يكون overflow إذا تجاوز المجموع max، وunderflow إذا انخفض دون min، وnone إذا لم يلزم التقييد.

هل يجوز أن يقع a أو b خارج مدى الكلمة؟

نعم. قد تكون المعاملات أي أعداد صحيحة آمنة؛ يُقيَّد المجموع فقط إلى min/max للكلمة. ذلك يلائم استخدام الحاسبات والتعليم عند استكشاف مدخلات خارج المدى.

ما عروض البت المدعومة؟

أي عرض من 2 إلى 64 بت. افتراضيًا تكون الكلمة بإشارة، مثل المدى من −128 إلى 127 في 8 بت، ودون إشارة يبدأ المدى من الصفر ويصل إلى اثنين مرفوعًا إلى العرض ناقص واحد.

لماذا التقييد بدل ترك المجموع يلتف؟

لأن النتيجة الملتفة قد تقفز من قيمة موجبة كبيرة إلى قيمة سالبة كبيرة، وهي مفاجأة سيئة في الصوت أو قنوات اللون أو عدادات السلامة. أما التقييد فيثبّت النتيجة عند أقرب حد، كما تفعل كثير من مجموعات تعليمات DSP وبرامج ترميز الوسائط.

أدوات ذات صلة

للمطوّرين — الوصول عبر API

كل ما في هذه الصفحة متاح برمجيًا. هذا القسم موجّه للفرق التقنية التي تريد ربط الأداة بأنظمتها الخاصة؛ بقية المستخدمين يمكنهم استخدام الأداة أعلاه مباشرة دون الحاجة لقراءة ما يلي.

الـEndpoint

POSThttps://api.kit.forhosting.com/dev/saturating-add

صادِق على طلبك بترويسة Bearer، وأرسل طلب POST واحدًا لتدخل مهمتك قائمة التنفيذ فورًا؛ ثم تستلم النتيجة عبر webhook أو رابط موقّع.

استدعِ الخدمة من بيئتك

curl -X POST https://api.kit.forhosting.com/dev/saturating-add \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"a":100,"b":50,"bits":8}'

const res = await fetch("https://api.kit.forhosting.com/dev/saturating-add", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "a": 100,
    "b": 50,
    "bits": 8
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/dev/saturating-add",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "a": 100,
    "b": 50,
    "bits": 8
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/dev/saturating-add", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"a":100,"b":50,"bits":8}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"a":100,"b":50,"bits":8}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/dev/saturating-add", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

مثال على الطلب

{
  "a": 100,
  "b": 50,
  "bits": 8
}

مثال على الاستجابة

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "dev.saturating_add",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

الواجهة غير متزامنة: تستلم task_id فور الإرسال، ويمكنك الاستعلام عن الحالة بمعدل طلب واحد في الثانية.

الأسعار

لكل طلب$0.002

السعر معلن كما تراه: لا tokens ولا نظام نقاط؛ وإن فشلت المهمة فلن تُحاسَب عليها.

الأخطاء

HTTP	الرمز	المعنى
`401`	`unauthorized`	مفتاح الوصول مفقود أو غير صالح؛ تحقق من ترويسة Bearer في طلبك.
`402`	`insufficient_balance`	رصيدك لا يكفي لتنفيذ هذه المهمة؛ أعد شحن الرصيد ثم أعد المحاولة.
`404`	`unknown_type`	نوع المهمة المطلوب غير موجود في الكتالوج — راجع الاسم المرسل في الطلب.
`429`	`rate_limited`	تجاوزت الحد المسموح من الطلبات؛ انتظر قليلًا ثم أعد المحاولة.

ملاحظات تقنية

المنطق النقي نفسه يغذي أداة المتصفح المجانية ومسار API، فلا تختلف فحوص الواجبات وخطوط الإنتاج أبدًا عند حالة حدية على حدود int8 أو uint16.

عقد الإدخال وشكل الاستجابة وسلوك الخطأ

الحقل الاختياري signed يكون true افتراضيًا لكلمة موقَّعة بتكملة الاثنين؛ اضبط signed على false لمدى غير موقَّع يبدأ من الصفر. تُقبل سلاسل شبيهة بالمنطق مثل true وfalse وyes وno وsigned وunsigned للتيسير. اقرن الاستجابة باختبارات وحدوية تثبت مساري التشبع وعدمه حتى لا تتسلل انحدارات منطق التقييد إلى نموذج برنامج ثابت أو ورقة توازن لعبة. أرسل جسم JSON بطريقة POST يتضمن الحقلين الإلزاميين a وb كعددين صحيحين نهائيين (أرقام JSON أو سلاسل أرقام بعلامة اختيارية في البداية) يبقى مطلقها ضمن Number.MAX_SAFE_INTEGER، وbits كعدد صحيح من اثنين إلى أربعة وستين. الحقول الناقصة وغير الصحيحة وbits خارج اثنين إلى أربعة وستين وقيم signed غير المنطقية تفشل بـ invalid_input مع تسمية المشكلة؛ ولا تُحاسب تلك الإخفاقات. عند النجاح يعيد الجسم a وb وbits وsigned؛ ويبلغ عن min وmax للكلمة؛ ويبلغ عن sum_exact كالمجموع الرياضي غير المقيَّد؛ ويبلغ عن result كالقيمة المقيَّدة؛ ويضع saturated على true عند حدوث التقييد؛ ويثبت direction على none أو overflow أو underflow. القيم التي تتجاوز أعداد JavaScript الآمنة عند أطراف المدى أو في المجموع الدقيق تُصدَر كسلاسل عشرية ليبقى JSON دقيقًا. مثال: a يساوي مئة وb يساوي خمسين وbits يساوي ثمانية وsigned true يعطي min سالب مئة وثمانية وعشرين وmax مئة وسبعة وعشرين وsum_exact مئة وخمسين وresult مئة وسبعة وعشرين وsaturated true وdirection overflow — حالة الجمع المشبع الكلاسيكية لـ int8.

أين تثبت واجهة API للجمع المشبع للأعداد الصحيحة قيمتها

ويقيّد مؤلفو الألعاب والمحاكاة الصحة والضرر وعدادات الموارد حتى لا يلتف الفيضان شريطًا شبه ممتلئ إلى قيمة سالبة أو شبه صفرية؛ وتجعل حاسبة عامة وواجهة API قواعد التقييد تلك قابلة للمراجعة في وثائق التصميم. ولأن التنفيذ parse من المستوى A خالص، تكلف كل مكالمة ناجحة السعر الأساسي المنشور $0.002 بلا رموز نموذج وبلا شبكة صادرة.

حالات التكامل

عروض صفية: الفيضان مقابل التشبع

أظهر للطلاب الفرق بين الالتفاف المعياري والتقييد المشبع مع min وmax وsum_exact وresult حتمية لأي عرض 2–64.

أسئلة تقنية

ما عروض البت وأوضاع الإشارة المدعومة؟

يجب أن يكون bits عددًا صحيحًا من 2 إلى 64. signed يكون true افتراضيًا (مدى تكملة الاثنين). اضبط signed false للمدى غير الموقَّع [0, 2^bits−1].

كم تكلفة حاسبة الجمع المشبع للأعداد الصحيحة؟

أداة المتصفح مجانية. طلبات API تستخدم رصيد KIT المدفوع مسبقًا بسعر $0.002 لكل مكالمة ناجحة؛ والمدخل غير الصالح لا يُحاسب.

اطّلع على توثيق KIT الكامل ←

شغّل الأداة مجانًا