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

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

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

string.indexOf(val)

string.indexOf(val, from)

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

المعاملات

val

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

from

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

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

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

أمثلة

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

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

void loop() {
  Serial.println(stringValue.indexOf("wiki"));    // 5
  Serial.println(stringValue.indexOf("wiki", 7)); // 10
}

انظر أيضًا

• التابع charAt()‎: يجلب محرفًا ذا فهرس محدَّد من السلسلة النصية التي استدعيت معها.
• التابع getBytes()‎: يجلب عددًا محدَّدًا من بايتات السلسلة النصية التي استدعيت معه ويضعه في مخزَّن معيَّن.
• التابع lastIndexOf()‎: تعيد فهرس آخر ظهور لمحرف أو سلسلة نصية معيَّنة ضمن السلسلة النصية التي استدعيت معه.
• التابع length()‎: يعيد عدد محارف السلسلة النصية التي استدعيت معه.
• التابع replace()‎: يبدِّل محرفًا أو سلسلةً نصيةً فرعيةً مكان محرف أو سلسلة نصية فرعية محدَّدة موجودة في السلسلة النصية التي استدعيت معه.

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

مصادر

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