Arduino/stringobject/replace

يبدِّل التابع replace()‎ محرفًا أو سلسلةً نصيةً فرعيةً مكان محرف أو سلسلة نصية فرعية محدَّدة موجودة في السلسلة النصية التي استدعيت معه.

البنية العامة

string.replace(substring1, substring2)

تمثِّل string السلسلة النصية التي يراد تبديل قيمة المعامل substring2 مكان قيمة المعامل substring1 أينما وجدت فيها.

المعاملات

substring1

القيمة التي يراد استبدال قيمة أخرى بها. يمكن أن يكون هذا المعامل محرفًا أو سلسلةً نصيةً فرعيةً.

substring2

القيمة التي ستحل مكان قيمة المعامل substring1 أينما وُجدَت في السلسلة النصية المعطاة.

القيم المعادة

لا يعاد أي شيء.

أمثلة

مثال على استعمال التابع replace()‎:

String stringValue = "wiki Hsoub";

void setup() {
  Serial.begin(9600);
}

void loop() {
  stringValue.replace("wiki", "academy");
  Serial.println(stringValue); // academy Hsoub
  stringValue.replace('a', '2');
  Serial.println(stringValue); // 2c2demy Hsoub
}

انظر أيضًا

• التابع charAt()‎: يجلب محرفًا ذا فهرس محدَّد من السلسلة النصية التي استدعيت معها.
• التابع compareTo()‎: يوازن بين سلسلتين نصيتين ويحدِّد أيهما أكبر من الأخرى أو إن كانتا متساويتين.
• التابع equals()‎: يتحقَّق إن كانت السلسلة النصية التي استدعيت معه مساويةً للسلسلة النصية التي مُرِّرت إليه.
• التابع getBytes()‎: يجلب عددًا محدَّدًا من بايتات السلسلة النصية التي استدعيت معه ويضعه في مخزَّن معيَّن.
• التابع setCharAt()‎: يعيِّن قيمة محرفٍ متوضِّع في السلسلة النصية التي استدعيت معه إلى المحرف المُمرَّر إليه.

• التابع startsWith()‎: تتحقَّق إن كانت السلسلة النصية التي استدعيت معه تبدأ بالمحارف نفسها التي مُرِّرت إليه.

• التابع substring()‎: يجلب جزءًا محدَّدًا من السلسلة النصية التي استدعيت معه.
• التابع trim()‎: يزيل جميع المسافات البيضاء من بداية ونهاية السلسلة النصية التي استدعيت معه.

مصادر

• صفحة التابع replace()‎ في توثيق أردوينو الرسمي.