وظيفة TRANSLATE ER

تقوم الدالة TRANSLATE بإرجاع قيمة سلسلة تحتوي على نتيجة استبدال النص المحدد بأحرف بمجموعة أحرف أخرى متوفرة.

بناء الجملة

TRANSLATE (text , pattern, replacement)

الوسائط

text: سلسلة

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

pattern: سلسلة

النص الذي يجب استبداله.

replacement: سلسلة

النص الذي سيتم استخدامه كبديل.

إرجاع القيم

سلسلة

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

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

تقوم الدالة TRANSLATE باستبدال كل حرف على حدة. تقوم الدالة باستبدال الحرف الأول للوسيطة text بالحرف الأول من الوسيطة pattern ثم الحرف الثاني وتتبع سير العمل نفسه حتى الانتهاء. عندما يتطابق حرف من الوسيطتين text وpattern، يتم استبداله بحرف من الوسيطة replacement الموجودة في الموضع نفسه للحرف من الوسيطة pattern. إذا ظهر أحد الأحرف عدة مرات في الوسيطة pattern، فسيتم استخدام تعيين الوسيطة replacement الذي يتطابق مع الحدوث الأول لهذا الحرف.

مثال1

تقوم الدالة TRANSLATE ("abcdef", "cd", "GH") باستبدال الحرف "c" للنص “abcdef” المحدد بالحرف "G" للنص replacement للأسباب التالية:

• تم تقديم الحرف "c" في النص pattern في الموضع الأول.
• يحتوي الموضع الأول للنص replacement على الحرف "G".

مثال2

تقوم الدالة TRANSLATE ("abcdef", "ccd", "GH") بإرجاع "abGdef".

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

تُرجع الدالة TRANSLATE ("abccba", "abc", "123")"123321".

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

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