List Operations

توفّر هذه الدالة مجموعة من عمليات التعامل الشائعة مع القوائم في واجهة واحدة سهلة الاستخدام. اختر عملية من القوائم المنسدلة وسيتكيّف البلوك تلقائيًا مع المدخلات والمخرجات المناسبة، بحيث يمكنك العمل مع القوائم (إنشاء، استعلام، تعديل، دمج، ترشيح والمزيد) بدون كتابة أي كود.

📥 المدخلات (Inputs)

تتغير المدخلات المتاحة ديناميكيًا بناءً على العملية المختارة.

List مدخل قائمة عام يُستخدم في العديد من العمليات.

Element عنصر مفرد للإضافة أو الإزالة أو البحث.

Index فهرس صحيح للعمليات مثل Get, Set, Insert أو Pop.

List(s) عند دمج قوائم متعددة (مثل Pair) يستقبل هذا المقبس قائمة من القوائم.

List (String) نص واحد يُستخدم بواسطة الطريقة Create لبناء قائمة من سلسلة مفصولة بفواصل.

(تظهر أسماء مآخذ إدخال أخرى حسب الحاجة وفقًا للطريقة المختارة.)

📤 المخرجات (Outputs)

المخرجات أيضًا ديناميكية وتعكس الطريقة المختارة.

List القائمة المرجعة بعد عمليات التعديل (مثلاً append، extend، remove).

Filtered List نتيجة عملية الترشيح.

Element عنصر مفرد يتم إرجاعه بواسطة Get, Min, Max، إلخ.

Size الطول المرجع بواسطة طريقة Len.

Index فهرس عنصر لطريقة Index.

(تظهر مآخذ مخرجات إضافية حسب الطريقة المختارة.)

🕹️ الضوابط (Controls)

Select a method قائمة منسدلة مع زر إجراء صغير. اختر عملية القوائم المطلوبة (أمثلة: append, extend, filter, create, len, min, max, slice, pair). يقوم البلوك بتحديث المآخذ تلقائيًا عند تغيير الاختيار.

Info منطقة نص صغيرة تعرض تلميحات الاستخدام للطريقة المختارة (على سبيل المثال، تذكير بأن شروط الفلترة يجب أن تكون قائمة بوليانية بنفس الطول).

🎨 الميزات (Features)

• مآخذ ديناميكية: تُنشأ أو تُزال المآخذ تلقائيًا عند اختيار طريقة، مما يحافظ على واجهة مرتبة.

• مجموعة عمليات واسعة: يدعم الإنشاء، الاستعلام، التعديل، والدمج (append, extend, insert, pop, remove, filter, slice, sort, reverse, sum, min/max, index, set, pair، والمزيد).

• تحقق مدمج: ينبه عند خروج الفهارس عن النطاق أو عند عدم تطابق أحجام القوائم لعمليات مثل filter أو pair.

• الإنشاء من نص: بناء قائمة بسرعة من سلسلة مفصولة بفواصل باستخدام طريقة Create.

⚙️ آلية التشغيل (Running mechanism)

1. اختر طريقة عبر التحكم Select a method.

2. يقوم البلوك بتحديث مآخذ المدخلات والمخرجات ليتوافق مع العملية المحددة.

3. قدّم المدخلات المطلوبة عن طريق توصيل بلوكات أخرى أو إدخال قيم يدويًا.

4. عند تشغيل السيناريو، ينفّذ البلوك العملية المختارة ويوفّر النتيجة على مآخذ المخرجات المحددة.

5. إذا كانت المدخلات غير صالحة (مثل اختلاف الأحجام أو فهرس غير صالح)، يعرض البلوك رسالة خطأ ويعيد نتيجة افتراضية آمنة عند الحاجة.

📝 تعليمات الاستخدام (Usage instructions)

1. افتح البلوك واختر العملية المطلوبة من Select a method.

2. اطلع على نص Info الظاهر للحصول على إرشادات سريعة حول تلك الطريقة.

3. وصل المدخلات المناسبة (مثال: وصل قائمة وعنصر لـ Append).

4. شغّل السيناريو واقرأ النتائج من مآخذ المخرجات التي ظهرت للطريقة المختارة.

💡 نصائح وحيل (Tips and Tricks)

Create استخدمه مع بلوك String Input لتمكين المستخدمين من إدخال عناصر مفصولة بفواصل، ثم تحويلها تلقائيًا إلى قائمة.

Filter و Filter Inverse عند ترشيح البيانات، أنتج قائمة الشروط باستخدام بلوكات منطقية مثل Equals, Greater أو Less ثم أدخل تلك القائمة البوليانية في هذا البلوك لاستخراج العناصر المطابقة.

Pair مفيد لدمج تدفقات بيانات موازية. يعمل جيدًا مع مخرجات من Object Detection أو Object Detection - Custom عندما تملك قوائم موازية (مثلاً، المواضع والأحجام) وترغب بضمها معًا للتسجيل أو التصدير لاحقًا.

Get, Index, Min, Max ادمج مع Get Element, Exclude Nones أو Replace None لتنقية المدخلات قبل الاستعلام أو التجميع.

Sum, Len استخدم مع Scope أو CSV Export لجمع ملخصات عددية للرسم البياني أو التسجيل.

Slice عند معالجة دفعات من العناصر، ادمج مع Debatch أو Batch Processing للتكرار ومعالجة القوائم الفرعية.

عام

• استخدم Data Memory عندما تريد الحفاظ على قائمة ثابتة حتى يصل تحديث صريح.

• أنشئ أنابيب تسجيل أو تصدير: بعد إعادة هيكلة القوائم هنا، أرسل النتائج إلى Data to JSON أو CSV Export للتخزين الخارجي.

• عند بناء قوائم من مصادر نصية، استخدم Find Substring و String Merge لتحضير السلاسل قبل استخدام طريقة Create.

(جهّز هذه البلوكات المرتبطة في مساحة العمل لبناء أنابيب قوية)

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

Filter وعدم تطابق الأحجام إذا ظهرت لك رسالة خطأ حول عدم تساوي الأحجام، تأكد أن قائمة الشروط لها نفس عدد العناصر كقائمة البيانات. استخدم Get Batch Size أو Len للتحقق من الأحجام.

Index out of range بالنسبة للطرق التي تأخذ فهرسًا (Get, Set, Insert, Pop)، تحقق من حدود الفهارس قبل التوصيل. استخدم Len أو Get Batch Size للحصول على نطاقات صالحة.

Unexpected types بعض العمليات تتوقع عناصر رقمية أو قابلة للمقارنة (لـ Sum, Min, Max, Sort). استخدم Replace None و Exclude Nones لتنظيف القائمة أولًا.

Creating lists from text عند استخدام Create, تأكد أن العناصر مفصولة بفواصل. يتم اقتطاع الفراغات الزائدة تلقائيًا، لكن الرموز غير الرقمية تبقى نصوصًا — تحقق مرتين باستخدام Find Substring أو String Operations إذا كنت بحاجة إلى تحليل إضافي.

إذا واجهت مشكلات مستمرة، اطلع على تلميح Info للطريقة المختارة — غالبًا ما يحتوي على إرشادات سريعة خاصة بالطريقة.