الدالات Left وMid وRight

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

استخراج الجزء الأيسر أو الأوسط أو الأيمن من سلسلة نصية.

‏‏الوصف

تقوم وظائف Left، وMid، وRight بإرجاع جزء من السلسلة.

  • ترجع الدالة اليسرى أحرف البداية لسلسلة.
  • يرجع Mid الأحرف الوسطى لسلسلة.
  • ترجع القائمة إلى اليمين أحرف نهاية سلسلة.

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

إذا كان موضع البداية سالبًا أو بعد نهاية السلسلة، فإن الوظيفة Mid تقوم بإرجاع فارغ. يمكنك التحقق من طول سلسلة باستخدام وظيفة Len. إذا طلبت أحرفًا أكثر من السلسلة، فستقوم الوظيفة بإرجاع أكبر عدد ممكن من الأحرف.

بناء الجملة

اليسار ( سلسلة ، عدد الأحرف )
منتصف ( سلسلة ، موضع البداية عدد الأحرف ])
يمين ( سلسلة ، عدد الأحرف )

  • سلسلة - مطلوب. السلسلة إلى التي يتم استخراج النتيجة منها.
  • StartingPosition - مطلوب (منتصف فقط). موضع البداية. الحرف الأول من السلسلة هو الموضع 1.
  • NumberOfCharacters - مطلوب (يسار ويمين فقط). عدد الأحرف المُراد إرجاعها. في حالة الحذف لوظيفة Mid، تقوم الوظيفة بإرجاع الجزء من موضع البداية حتى نهاية السلسلة.

اليسار ( جدول عمود واحد ، عدد الأحرف )
منتصف ( جدول عمود واحد ، موضع البدء عدد الأحرف ])
يمين ( جدول عمود واحد ، عدد الأحرف )

  • SingleColumnTable - مطلوب. جدول أحادي العمود من السلاسل لاستخراج النتائج منه.
  • StartingPosition - مطلوب (منتصف فقط). موضع البداية. الحرف الأول من السلسلة هو الموضع 1.
  • NumberOfCharacters - مطلوب (يسار ويمين فقط). عدد الأحرف المُراد إرجاعها. في حالة الحذف لوظيفة Mid، تقوم الوظيفة بإرجاع الجزء من موضع البداية حتى نهاية السلسلة.

الأمثلة

سلسلة واحدة

تستخدم الأمثلة في هذا القسم عنصر تحكم إدخال النص باعتباره مصدر البيانات. يسمى عنصر التحكم Author ويحتوي على السلسلة "E. E. Cummings".

صيغة ‏‏الوصف نتيجة
اليسار ( المؤلف النص ، 5 ) استخراج ما يصل إلى خمسة أحرف من بداية السلسلة. "E. E."
منتصف ( المؤلف النص ، 7 ، 4 ) استخراج ما يصل إلى أربعة أحرف، بدءًا من الحرف السابع، من السلسلة. "Cumm"
منتصف ( المؤلف - النص ، 7 ) استخراج جميع الأحرف، بدءًا من الحرف السابع، من السلسلة. "Cummings"
يمين ( المؤلف - النص ، 5 ) استخراج ما يصل إلى خمسة أحرف من نهاية السلسلة. "mings"

جدول من عمود واحد

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

الاسم عنوان
"Jean" "123 Main St NE"
"Fred" "789 SW 39th #3B"
الصيغة الوصف نتيجة
اليسار (ShowColumns (الناس ، "العنوان") ، 8) استخراج الأحرف الثمانية الأولى من كل سلسلة. جدول بعمود واحد بعمود Value يحتوي على القيم التالية: "123 Main"،‏ "789 SW 3"
منتصف ( ShowColumns (الناس ، "العنوان") ، 5 ، 7 ) استخراج الأحرف السبع الوسطى من كل سلسلة، بدءًا بالحرف الخامس. جدول بعمود واحد بعمود Value يحتوي على القيم التالية: "Main St"،‏ "SW 39th"
اليمين (ShowColumns( الناس ، "العنوان") ، 7) استخراج آخر سبعة أحرف من كل سلسلة. جدول بعمود واحد بعمود Value يحتوي على القيم التالية: "n St NE"،‏ "9th #3B"

مثال خطوة بخطوة

  1. استورد أو أنشئ مجموعة تُسمى المخزون، واعرضها في معرض، على النحو الذي يصفه الإجراء الأول في إظهار الصور والنص في معرض.

  2. قم بتعيين خاصية Text الخاصة بالتسمية السفلية في المعرض إلى هذه الوظيفة:

    اليمين (ThisItem.ProductName ، 3)

    تعرض التسمية الأحرف الثلاثة الأخيرة لكل اسم منتج.