SPLIT ER وظيفة

تقسم الوظيفة SPLIT سلسلة الإدخال المُحددة إلى سلاسل فرعية وتُرجع النتيجة كقيمة قائمة سجلات جديدة.

بناء الجملة 1

SPLIT (input, length)

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

بناء الجملة 2

SPLIT (input, delimiter)

يستخدم بناء الجملة هذا لتقسيم سلسلة الإدخال المحددة إلى سلاسل فرعية، استنادًا إلى المحدد المعين.

الوسائط

input: سلسلة

النص المراد تقسيمه.

length: عدد صحيح

الحد الأقصى لطول سلسلة فرعية واحدة.

delimiter: سلسلة

مُحدد يستخدم لفصل السلاسل الفرعية.

إرجاع القيم

قائمة السجلات

قائمة السجلات الناتجة.

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

تتكون بنية سجل القائمة التي تم إرجاعها من حقل القيمة من نوع السلسلة. يحتوي كل سجل من القائمة التي تم إرجاعها على سلاسل فرعية تم إنشاؤها في هذا الحقل.

إذا كانت وسيطة delimiter فارغة، تتكون القائمة الجديدة التي تم إرجاعها من سجل واحد يحتوي على الحقل القيمة من نوع السلسلة. يحتوي هذا الحقل علي نص الإدخال.

إذا كانت الوسيطة input فارغة، يتم إرجاع قائمة فارغة جديدة. إذا لم يتم تعيين الوسيطة input أو delimiter (null)، يتم طرح استثناء تطبيق.

مثال1

تُرجع الدالة SPLIT ("abcd", 3) قائمة جديدة تتكون من سجلين لديهما حقل القيمة من نوع السلسلة. يحتوي حقل القيمة في السجل الأول على النص "abc" ، ويحتوي حقل القيمة في السجل الثاني على النص "d".

مثال2

تُرجع الدالة SPLIT ("XAb aBy", "aB") قائمة جديدة تتكون من ثلاث سجلات لديهم حقل القيمة من نوع السلسلة. يحتوي حقل القيمة في السجل الأول على النص "X"، ويحتوي حقل القيمة‏‎ في السجل الثاني على النص " "، ويحتوي حقل القيمة‏‎ في السجل الثالث على النص "y".

المثال الثالث

يمكنك استخدام الدالة INDEX للوصول إلى العناصر الفردية لإعداد الإدخال المحدد. إذا قمت بإدخال مصدر البيانات MyList من النوع الحقل المحسوب وقمت بتكوينه للتعبير SPLIT("abc", 1)، يرجع التعبير INDEX(MyList,2).Value النص "b".

المثال الرابع

يمكنك استخدام الدالة ENUMERATE لمساعدتك في الوصول إلى العناصر الفردية لإعداد الإدخال المحدد. إذا قمت أولاً بإدخال مصدر البيانات MyList للنوع الحقل المحسوب وقمت بتكوينه للتعبير SPLIT("abc", 1)، ثم أدخلت مصدر البيانات EnumeratedList للنوع الحقل المحسوب وقمت بتكوينه للتعبير ENUMERATE(MyList)، يرجع التعبير FIRSTORNULL(WHERE(EnumeratedList, EnumeratedList.Number=2)).Value النص "b".

الموارد الإضافية

دالات القائمة