Arduino/stringobject/remove

يحذف التابع remove()‎ عددًا محدَّدًا من محارف السلسلة النصية التي استدعيت معها. انتبه إلى أنَّ هذه الدالة تعدِّل نفس السلسلة النصية المعطاة، لذا كن حذرًا عند استعمالها.

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

string.remove(index)

string.remove(index, count)

تمثِّل string السلسلة النصية التي يراد حذف محارفها التي تبدأ عند المحرف ذي الفهرس index وحتى نهاية السلسلة أو بعدد المحارف count فقط.

المعاملات

index

عددٌ صحيحٌ عديم الإشارة يمثِّل فهرس بداية المحارف المراد حذفها.

count

عددٌ صحيحٌ عديم الإشارة يمثِّل عدد العناصر المراد حذفها بدءًا من المحرف ذي الفهرس index. هذا المعامل اختياري، وستُحذَف العناصر بدءًا من العنصر ذي الفهرس index وحتى نهاية السلسلة النصية إن لم يُعطَ.

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

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

أمثلة

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

String stringValue = "wiki Hsoub";

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

void loop() {
  stringValue.remove(0, 1);
  Serial.println(stringValue); // iki Hsoub
  stringValue.remove(4);
  Serial.println(stringValue); // iki
}

انظر أيضًا

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

مصادر

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