الدالتان Replace وSubstitute

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

استبدل جزءًا من سلسلة نص بسلسلة أخرى.

الوصف

تقوم وظيفة Replace بتحديد النص المراد استبداله من خلال موضع البداية والطول.

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

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

بناء الجملة

Replace( String, StartingPosition, NumberOfCharacters, NewString )

• سلسلة - مطلوبة. السلسلة المراد العمل عليها.
• StartingPosition - مطلوب. موضع الحرف لبدء الاستبدال. الحرف الأول من السلسلة هو الموضع 1.
• NumberOfCharacters - مطلوب. عدد الأحرف المطلوب استبدالها في السلسلة.
• NewString - مطلوبة. سلسلة الاستبدال. يمكن أن يختلف عدد الأحرف في هذه الوسيطة عن وسيطة NumberOfCharacters.

Substitute( String, OldString, NewString [, InstanceNumber ] )

• سلسلة - مطلوبة. السلسلة المراد العمل عليها.
• OldString - مطلوبة. السلسلة المراد استبدالها.
• NewString - مطلوبة. سلسلة الاستبدال. يمكن أن تحتوي كل من OldString وNewString على أطوال مختلفة.
• InstanceNumber - اختياري. استخدم هذه الوسيطة لتحديد مثيل OldString المراد استبداله إذا كانت السلسلة تحتوي على أكثر من مثيل واحد. إذا لم تحدد هذه الوسيطة، فسيتم استبدال كل المثيلات.

Replace( SingleColumnTable, StartingPosition, NumberOfCharacters, NewString )

• SingleColumnTable - مطلوب. جدول من عمود واحد للسلاسل المراد العمل عليها.
• StartingPosition - مطلوب. موضع الحرف لبدء الاستبدال. الحرف الأول من كل سلسلة في الجدول في الموضع 1.
• NumberOfCharacters - مطلوب. عدد الأحرف المطلوب استبدالها في كل سلسلة.
• NewString - مطلوبة. سلسلة الاستبدال. يمكن أن يختلف عدد الأحرف في هذه الوسيطة عن وسيطة NumberOfCharacters.

Substitute( SingleColumnTable, OldString, NewString [, InstanceNumber ] )

• SingleColumnTable - مطلوب. جدول من عمود واحد للسلاسل المراد العمل عليها.
• OldString - مطلوبة. السلسلة المراد استبدالها.
• NewString - مطلوبة. سلسلة الاستبدال. يمكن أن تحتوي كل من OldString وNewString على أطوال مختلفة.
• InstanceNumber - اختياري. استخدم هذه الوسيطة لتحديد مثيل OldString المراد استبداله إذا كانت السلسلة تحتوي على أكثر من مثيل واحد. إذا لم تحدد هذه الوسيطة، فسيتم استبدال كل المثيلات.

الأمثلة

صيغة	‏‏الوصف	نتيجة
Replace( "abcdefghijk", 6, 5, "*" )	استبدال خمسة أحرف في "abcdefghijk" بحرف "*" واحد، بدءًا من الحرف السادس ("f").	"abcde*k"
Replace( "2019", 3, 2, "20" )	استبدال آخر حرفين من "2019" بـ "20".	"2020"
Replace( "123456", 1, 3, "_" )	استبدال الأحرف الثلاثة الأولى من "123456" بحرف "_" واحد.	"_456"
Substitute( "Sales Data", "Sales", "Cost" )	استبدال سلسلة "التكلفة" بـ "المبيعات".	"بيانات التكلفة"
Substitute( "Quarter 1, 2018", "1", "2", 1 )	استبدال المثيل الأول فقط من "1" بـ "2" لأن الوسيطة الرابعة (InstanceNumber) تم توفيرها مع a 1.	"ربع السنة الثاني، 2018"
Substitute( "Quarter 1, 2011", "1", "2", 3 )	استبدال المثيل الثالث فقط من "1" بـ "2" لأن الوسيطة الرابعة (InstanceNumber) تم توفيرها مع a 3.	"ربع السنة الأول، 2012"
Substitute( "Quarter 1, 2011", "1", "2" )	استبدال جميع المثيلات من "1" بـ "2" لأن الوسيطة الرابعة (InstanceNumber) لم يتم توفيرها.	"ربع السنة الثاني، 2022"
Replace( [ "Quarter 1, 2018", "Quarter 2, 2011", "Quarter 4, 2019" ], 9, 1, "3" )	استبدال الحرف التاسع في كل سجل من جدول العمود الواحد بـ "3".	جدول بعمود واحد بعمود Value يحتوي على القيم التالية: [ "Quarter 3, 2018", "Quarter 3, 2011", "Quarter 3, 2019" ]
Substitute( [ "Qtr 1, 2018", "Quarter 1, 2011", "Q1, 2019" ], "1", "3", 1 )	لأن الوسيطة الرابعة ( InstanceNumber) متوفرة مع القيمة 1، فإنه يتم استبدال المثال الأول "1" فقط في كل سجل من جدول العمود الواحد بـ "3".	جدول بعمود واحد بعمود Value يحتوي على القيم التالية: [ "Qtr 3, 2018", "Quarter 3, 2011", "Q3,2019"]
Substitute( [ "Qtr 1, 2018", "Quarter 1, 2011", "Q1, 2019" ], "1", "3" )	نظرًا لأنه لا يتم توفير الوسيطة الرابعة ( InstanceNumber)، فإنه يتم استبدال جميع مثيلات "1" في كل سجل من جدول العمود الواحد بـ "3".	جدول بعمود واحد بعمود Value يحتوي على القيم التالية: [ "Qtr 3, 2038", "Quarter 3, 2033", "Q3,2039"]