> 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/data-operations/get-element.md).

# Get Element

تقوم هذه دالة الكتلة باستخراج عنصر واحد من قائمة (Batch) مُقدمة باستخدام قيمة فهرس (Index). تكون مفيدة عندما تحتاج لاختيار عنصر واحد من مجموعة وتمريره إلى الكتل التالية في التدفق.

## 📥 المدخلات

`Batch` قائمة أو مجموعة من القيم (صور، أرقام، نصوص، إلخ) التي سيتم استخراج عنصر منها.

`Index` موقع العنصر (صفر-مبني) الذي يحدد أي عنصر يتم إرجاعه من الـ `Batch`.

## 📤 المخرجات

`Generic` العنصر المحدد من الـ `Batch`. نوع القيمة المرجعة يتوافق مع نوع العنصر الموجود داخل الدفعة.

## 🕹️ الضوابط

لا تحتوي هذه الدالة على عناصر تحكم تفاعلية. تعمل بقراءة مآخذ الإدخال المقدمة في كل خطوة تقييم.

## 🎨 الميزات

* استخراج بسيط ومباشر لعنصر واحد من قائمة أو دفعة.
* يعمل مع أي نوع بيانات عام داخل الدفعة (صور، أرقام، سلاسل، أشكال، إلخ).
* مصمم للتكامل السهل في التدفق عندما يكون هناك حاجة لمعالجة عنصر واحد فقط.

## 📝 تعليمات الاستخدام

1. مرّر قائمة أو دفعة إلى مدخل `Batch`.
2. مرّر موضع العنصر (بالبدايات من صفر) إلى مدخل `Index`.
3. تُخرج الكتلة العنصر الموجود في الموضع المطلوب عبر خرج `Generic`.
4. إذا كانت الدفعة ذات طول متغير، تأكد من أن قيمة الفهرس صالحة لتجنب نتائج غير متوقعة.

## 📊 التقييم

في كل تشغيل، تقرأ الكتلة قيم `Batch` و `Index` الحالية، ثم تُمرّر العنصر الموجود في ذلك الفهرس إلى المخرج. إذا أشار الفهرس إلى قيمة مفردة، فسيُعاد عنصر واحد؛ وعند دمجها مع تحكم تدفق التجميع (batching)، يمكن استخدامها لاختيار عناصر محددة للمعالجة اللاحقة.

## 💡 نصائح وحيل

* استخدم `Batch Processing` قبل هذه الكتلة عندما تريد تمرير بيانات مجمعة أو متدفقة وتقليل استهلاك الذاكرة.
* اجمعها مع `Debatch` لتحويل الدفعة إلى عناصر فردية ثم استخدم `Get Element` لاختيار عنصر محدد من ذلك التدفق.
* استخدم `Get Batch Size` للتحقق من طول الدفعة قبل اختيار فهرس؛ هذا يمنع الوصول خارج النطاق.
* استخدم `Is None` و `Replace None` بعد هذه الكتلة للتعامل مع القيم المفقودة بسلاسة.
* استخدم `Data Memory` لتجميد أو تخزين الدفعة مؤقتًا والحفاظ على نفس البيانات أثناء تجربة قيم فهرس مختلفة.
* استخدم `Debug Input` لفحص الـ `Batch` أو `Index` عندما تكون النتائج غير متوقعة.
* عند بناء خطوط معالجة صور مفهرسة، اجمعها مع كتل عرض مثل `Show Image` لمعاينة العنصر المحدد من الصورة.

## 🛠️ استكشاف الأخطاء وإصلاحها

* إذا حصلت على مخرج غير متوقع أو فارغ، فتأكّد أن الـ `Batch` يحتوي فعلاً على عناصر وأن `Index` ضمن النطاق الصالح (0..length-1).
* إذا كانت الحزمة أحيانًا توفر قيم None، فاستخدم `Is None` أو `Replace None` لحماية المعالجة اللاحقة.
* في تدفقات العمل ذات أحجام دفعات متغيرة، افحص دائمًا `Get Batch Size` قبل استخدام `Index` لتجنب الوصول غير الصالح.