> For the complete documentation index, see [llms.txt](https://docs.augelab.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.augelab.com/arabic/alblwkat-alwzyfyh/blocks-reference/data-logic/mathmetical-operations/counter.md).

# Counter

هذا البلوك الوظيفي يحتفظ بمجموع متزايد للقيم الرقمية الواردة. يفيد في عمليات التراكم البسيطة، العدّادات، أو دمج القيم مع مرور الوقت. استخدم مدخل `Reset` لمسح القيمة المتراكمة عند الحاجة.

## 📥 المدخلات <a href="#inputs" id="inputs"></a>

`Number`\
زوّد قيمة رقمية تُضاف إلى الإجمالي الجاري. كل تقييم يضيف هذه القيمة إلى التراكم الحالي.

`Reset`\
إشارة منطقية (boolean) تقوم بمسح الإجمالي المتراكم عندما تكون فعّالة (true).

## 📤 المخرجات <a href="#outputs" id="outputs"></a>

`Number`\
الإجمالي المتراكم الحالي بعد معالجة المدخلات.

## 🕹️ عناصر التحكم <a href="#controls" id="controls"></a>

لا يعرض هذا البلوك عناصر تحكم إضافية على البلوك نفسه أو منزلقات. يعمل استنادًا إلى المدخلات المقدمة.

## 🎯 الميزات <a href="#features" id="features"></a>

* الاحتفاظ بالتراكم للقيم الرقمية الواردة عبر مرات التشغيل.
* إمكانية إعادة التعيين الفورية عبر مدخل `Reset` للبدء من الصفر.
* تجاهل المدخلات غير المتصلة بحيث تؤثر على الإجمالي فقط المصادر الرقمية النشطة.

## 📝 إرشادات الاستخدام <a href="#usage" id="usage"></a>

1. وصل مصدرًا رقميًا بمدخل `Number` لزيادة العداد.
2. استخدم مصدرًا منطقياً على مدخل `Reset` لمسح العداد عند الحاجة.
3. اطلع على الإجمالي الحالي من مخرج البلوك `Number`.

## 📊 كيف يعمل <a href="#evaluation" id="evaluation"></a>

في كل تشغيل، يتحقق البلوك من مدخل `Number` ويضيفه إلى الإجمالي المخزن. إذا كان مدخل `Reset` مفعلًا، يتم مسح الإجمالي المخزن قبل المتابعة. يتم إرسال الإجمالي المحدث عبر المخرج `Number`.

## 💡 نصائح وحيل <a href="#tips-and-tricks" id="tips-and-tricks"></a>

* ادمجه مع `Number Input` لاختبار سلوك العدّ يدويًا.
* استخدم `Logic Input` كطريقة مريحة لتشغيل إشارة `Reset` من واجهة المستخدم.
* استخدم `Data Memory` لتجميد أو الاحتفاظ بإجمالي مسجل تحت ظروف معينة.
* أرسل المخرج إلى `CSV Export` أو `Data to JSON` لتسجيل الأعداد عبر الوقت للتحليل لاحقًا.
* قم بتصوير التغيرات الرقمية مباشرًة بربط المخرج إلى `Scope`.

## 🛠️ استكشاف الأخطاء وإصلاحها <a href="#troubleshooting" id="troubleshooting"></a>

* لا تغيير في الإجمالي: تأكد من أن مدخل `Number` متصل ويُنتج قيمًا رقمية. استخدم `Is None` أو `Data Type Converter` إذا لزم الأمر للتحقق من صحة المدخلات.
* قيم أو أنواع غير متوقعة: أدخل بلوكات عمليات رياضية مثل `Round` لتنقية الأعداد الواردة.
* الحاجة إلى حفظ دوري: صدّر المخرج باستخدام `CSV Export` أو `Data to JSON` حتى تُخزن الأعداد خارج السيناريو.