التابع String.lastIndexOf()‎ في أردوينو

يعيد التابع lastIndexOf()‎ فهرس آخر ظهور لمحرف أو سلسلة نصية معيَّنة ضمن السلسلة النصية التي استدعيت معه. تبحث الدالة ابتداءً من نهاية السلسلة النصية المعطاة افتراضيًّا، ولكن يمكن بدء البحث من أي موضع ضمن السلسلة النصية.

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

string.lastIndexOf(val)

string.lastIndexOf(val, from)

تمثِّل string السلسلة النصية التي سيُبحَث ضمنها عن قيمة المعامل val.

المعاملات

val

القيمة التي يراد البحث عنها وإعادة فهرس آخر ظهور لها ضمن السلسلة النصية المعطاة. يمكن أن يكون هذا المعامل محرفًا أو سلسلةً نصيةً.

from

فهرس المحرف الذي يراد بدء عملية البحث عنده انطلاقًا من نهاية السلسلة وحتى بدايتها. القيمة الافتراضية له هي: 1- (أي البحث بدءًا من المحرف الأخير).

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

يعاد فهرس القيمة val التي عثر عليها ضمن السلسلة النصية المعطاة، أو تعاد القيمة 1- إن لم يُعثَر على تلك القيمة.

أمثلة

مثال على استعمال الدالة lastIndexOf()‎:

String stringValue = "Wiki Hsoub wiki wiki";
void setup() {
   Serial.begin(9600);
}

void loop() {
  Serial.println(stringValue.lastIndexOf("wiki"));    // 16
  Serial.println(stringValue.lastIndexOf("wiki", 3)); // -1
}

انظر أيضًا

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

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

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

مصادر

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