> 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/string-operations.md).

# String Operations

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

## 📥 Inputs

* `String` النص الرئيسي للمعالجة (الدخل الأساسي).\
  ملاحظة: مقابس المدخلات تتغير اعتمادًا على `Method` المختارة. على سبيل المثال، بعض العمليات تضيف دخل `String` ثانٍ لجزء نصي أو فاصل، أو تسمح بعدة مدخلات نصية.

## 📤 Outputs

* `String` / `Number` / `Boolean` / أنواع أخرى حسب الطريقة المختارة.\
  ملاحظة: المخارج تتحدّث لتعكس العملية المحددة — على سبيل المثال: عملية العد تُرجع رقمًا، فحص الانتماء يُرجع قيمة منطقية، و`Split` يُرجع قائمة من النصوص.

## 🕹️ Controls

* `Method` قائمة منسدلة لاختيار عملية النص المراد تطبيقها. الخيارات المتاحة تتضمن، على سبيل المثال: `Upper`, `Lower`, `Count`, `Merge`, `Split`, `Replace`, `Length`, `StartsWith`, `EndsWith`, `Join`, `Reverse`, `Remove Digits` والمزيد.

عند تغيير `Method`، سيقوم البلوك تلقائيًا بضبط المداخل والمخارج المرئية لتتناسب مع العملية المختارة.

## 🎨 Features

* `Adaptive Sockets` — تتغير المداخل والمخارج ديناميكيًا بناءً على الطريقة المختارة بحيث ترى فقط الضوابط التي تحتاجها.
* `Wide Method Library` — مكتبة واسعة من العمليات مثل تحويل حالة الأحرف، البحث، التقسيم/الدمج، الاستبدال، الفحوص (isdigit/isalpha/etc.)، التقليم وعمليات مساعدة مثل الطول والعكس.
* `Simple UI` — اختر العملية واصل مصادر النص المطلوبة — لا حاجة للبرمجة.

## 📝 Usage Instructions

1. اختر العملية المطلوبة من قائمة `Method` المنسدلة.
2. وصل مصدر النص الرئيسي إلى مدخل `String`. إذا كانت العملية المختارة تحتاج قيمًا إضافية (مثل جزء نصي أو فاصل)، ستظهر مقابس إدخال إضافية — قدّم هذه القيم.
3. اطلع على النتيجة من مخرجات البلوك المعروضة على البلوك. نوع المخرج يعتمد على العملية المختارة (نص، رقم، منطقي، أو قائمة).

أمثلة:

* استخدم `Upper` لتحويل النص إلى حروف كبيرة.
* استخدم `Replace` لاستبدال جزء نصي بآخر. قدّم النص الرئيسي والمدخلين القديم/الجديد.
* استخدم `Split` لإنتاج قائمة من الأجزاء بتحديد فاصل.

## 📊 Evaluation

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

## 💡 Tips and Tricks

* ادمج مع `String Input` لتزويد قيم نصية يدوياً أثناء الاختبار أو بناء نماذج صغيرة.
* استخدم `Find Substring` ثم `Replace` على التوالي لتحديد وتحويل أجزاء معينة من النص قبل التسجيل أو التصدير.
* أرسل النتائج إلى `Data to JSON` أو `CSV Export` عند الحاجة لتسجيل النص المعالج لتحليل لاحق أو تقارير.
* استخدم `Debug Input` لتفحص قيم النص الوسيطة بسرعة أثناء بناء التدفق.
* إذا كان مخرج النص سيُعرض للمستخدمين، طبّق `Strip` أو `Title Case` لتنظيف التنسيق قبل التصدير أو العرض.

## 🛠️ Troubleshooting

* إذا اختفت المدخلات المتوقعة بعد تغيير `Method`، أعد فتح البلوك وأعد توصيل المدخلات الجديدة الظاهرة — المقابس مصممة لتكون قابلة للتكيّف.
* إذا كنت تتوقع نتيجة رقمية أو منطقية لكن ترى نصًا، تأكد من اختيار `Method` الصحيح (بعض الطرق تُرجع أنواع بيانات مختلفة).
* في حال خروج مخرجات فارغة غير متوقعة، تحقق من البلوكات السابقة التي تزود النص (مثل `String Input` أو بلوكات القراءة) واستخدم `Debug Input` للتحقق من القيم.