REPLACE ER وظيفة

تقوم وظيفة REPLACE بإرجاع السلسلة النصية المُحددة كقيمة سلسلة بعد استبدالها كليًا أو جزئيًا بسلسلة أخرى.

بناء الجملة

REPLACE (text, pattern, replacement, regular expression flag)

الوسائط

text: سلسلة

المسار الصالح لمصدر البيانات من نوع السلسلة.

pattern: سلسلة

إذا كانت الوسيطة regular expression flagFALSE، تحتوي هذه الوسيطة على النص الذي يجب استبداله.

إذا كانت الوسيطة regular expression flagTRUE، تحتوي هذه الوسيطة على تعبير عادي يُعرف كل من نمط البحث ونص الاستبدال.

replacement: سلسلة

إذا كانت الوسيطة regular expression flagFALSE، تحتوي هذه الوسيطة على النص لاستخدامه كبديل.

إذا كانت الوسيطة regular expression flagTRUE، لا يتم استخدام هذه الوسيطة.

regular expression flag: منطقي

قيمة منطقية تشير إلى إذا ما كان يتم استخدام تعبير عادي للقيام بالاستبدال.

إرجاع القيم

سلسلة

القيمة النصية الناتجة.

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

إذا كانت الوسيطة regular expression flagTRUE، تقوم هذه الوظيفة بإرجاع السلسلة المُحددة بعد أن تم تغييرها عن طريق تطبيق التعبير العادي المُحدد بواسطة الوسيطة pattern. يتم استخدام التعبير العادي للبحث عن الأحرف التي يجب استبدالها.

إذا كانت الوسيطة regular expression flag بقيمة FALSE، ترجع هذه الدالة السلسلة المحددة بعد أن يتم استبدال مجموعة الأحرف التي تم تعريفها في الوسيطة pattern بأحرف من الوسيطة replacement.

مثال1

تطبّق REPLACE ("+1 923 456 4971", "[^0-9]", "", true) تعبيرًا عاديًا يقوم بإزالة كافة الرموز غير الرقيمة، وتُرجع ‎<2>‎‏ "19234564971".

مثال2

تستبدل REPLACE ("abcdef", "cd", "GH", false) النمط "cd" بالسلسلة "GH" وترجع "abGHef".

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

الدالات النصية