الدالة Split

تنطبق على: تطبيقات اللوحة تدفقات سطح المكتب التطبيقات التي تستند إلى النماذج Power Pages Power Platform CLI

تقسيم السلسلة النصية إلى جدول السلاسل الفرعية.

الوصف

تقسم وظيفة Split السلسلة النصية إلى جدول السلاسل الفرعية. استخدم Split لتقسيم قوائم الفواصل المحددة والتواريخ التي تستخدم خط مائل بين أجزاء التاريخ وفي حالات أخرى يتم فيها استخدام محدد جيد التعريف.

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

استخدم وظيفة Concat لإعادة تركيب السلسلة بدون الفواصل.

استخدم وظيفة MatchAll لتقسيم سلسلة باستخدام تعبير عادي.

توضح الأمثلة كيفية استخدام وظيفة Split مع وظيفتي First وLast لاستخراج سلسلة فرعية واحدة محددة. وظيفة Match غالبًا ما تكون خيارًا أكثر إيجازًا وقوة للتعبيرات العادية.

بناء الجملة

Split( النص، الفاصل )

• النص – مطلوب. النص المراد تقسيمه.
• الفاصلة - مطلوب. الفاصل الذي سيتم استخدامه في تقسيم السلسلة. يمكن ان يكون صفرا أو واحدا أو أكثر من الأحرف.

الأمثلة

الاستخدام الأساسي

صيغة	‏‏الوصف	نتيجة
Split( "Apples, Oranges, Bananas", "," )	يقسم النتائج المختلفة إلى أجزاء، بناءً على فاصل الفاصلة. يتم إجراء التقسيم بناءً على الفاصلة فقط وليس المسافة التي تليها، مما ينتج عنه مسافة في مقدمة "Oranges" و"Bananas".	جدول بعمود واحد مع عمود Value يحتوي على القيم التالية: "Apples"، و" Oranges"، و" Bananas"
TrimEnds( Split( "Apples, Oranges, Bananas", "," ) )	نفس المثال السابق، ولكن في هذه الحالة تتم إزالة المساحة بواسطة وظيفة TrimEnds، وتعمل على جدول عمود واحد يتم إنتاجه بواسطة وظيفة Split. كان بإمكاننا أيضًا استخدام الفاصل ", " الذي يتضمن المسافة بعد الفاصلة، لكن ذلك لم يكن ليعمل بشكل صحيح إذا لم تكن هناك مسافة أو كانت هناك مسافتان.	جدول بعمود واحد مع عمود Value يحتوي على القيم التالية: "Apples"، و" Oranges"، و" Bananas"
Split( "08/28/17", "/" )	تقسيم التاريخ إلى قسمين، باستخدام شرطة مائلة للأمام كفاصل.	جدول بعمود واحد بعمود Value يحتوي على القيم التالية: "08"، "28"، "17"

محددات مختلفة

الصيغة	الوصف	نتيجة
Split( "Hello, World", "," )	تقسيم الكلمات عن بعضها باستخدام فاصلة كفاصل. تبدأ النتيجة الثانية بمسافة حيث تكون هذه هي الحرف الذي يلي الفاصلة مباشرة.	جدول بعمود واحد بعمود Value يحتوي على القيم التالية: "Hello"،‏ " World"
Split( "Hello, World", "o" )	تقسيم السلسلة، باستخدام الحرف "o" كفاصل.	جدول بعمود واحد بعمود Value يحتوي على القيم التالية: "Hell"،‏ "،W"،‏ "rld"
Split( "Hello, World", "l" )	تقسيم السلسلة، باستخدام الحرف الفردي "l" كفاصل. نظرًا لعدم وجود أحرف بين كلٍّ من l وHello، يتم إرجاع قيمة فارغة.	جدول بعمود واحد بعمود Value يحتوي على القيم التالية: "He"،‏ Blank()،‏ "o،‏ Wor"،‏ "d"
Split( "Hello, World", "ll" )	تقسيم السلسلة، باستخدام الحرف المزدوج "ll" كفاصل.	جدول بعمود واحد بعمود Value يحتوي على القيم التالية: "He"،‏ "o،‏ World"
Split( "Hello, World", "%" )	تقسيم السلسلة، باستخدام علامة النسبة المئوية كفاصل. نظرًا لأن هذا الفاصل لا يظهر في السلسلة، يتم إرجاع السلسلة بأكملها كنتيجة واحدة.	جدول بعمود واحد بعمود Value يحتوي على القيم التالية: "Hello،‏ World"
Split( "Hello, World", "" )	تقسيم السلسلة، باستخدام سلسلة فارغة كفاصل (أحرف صفر). سيؤدي هذا إلى فصل السلسلة على كل حرف.	جدول بعمود واحد بعمود Value يحتوي على القيم التالية: "H"،‏ "e"،‏ "l"،‏ "l"،‏ "o"‏، ","، " "،‏ "W"،‏ "o"،‏ "r"،‏ "l"،‏ "d"

استخراج السلسلة الفرعية

الصيغة	الوصف	نتيجة
First( Split( Last( Split( "Bob Jones <bob.jones@contoso.com>", "<" ) ).Result, ">" ) ).Result	تقسيم السلسلة بناءً على محدد الافتتاح (<) واستخراج السلسلة إلى يمين المحدد باستخدام الأخير. ثم تقوم الصيغة بتقسيم تلك النتيجة استنادًا إلى محدد الإغلاق (>) وتستخرج السلسلة الموجودة على يسار المحدد باستخدام اليمين.	"bob.jones@contoso.com"
Match( "Bob Jones <bob.jones@contoso.com>", "<(?<email>.+)>" ).email	تنفيذ نفس الاستخراج القائم على المحدد كما في المثال الأخير ولكنه يستخدم وظيفة Match والتعبير العادي بدلًا من ذلك.	"bob.jones@contoso.com"