الفرق بين المراجعتين لصفحة: «Arduino/stringobject/indexof»

المراجعة الحالية بتاريخ 22:01، 6 نوفمبر 2018

يعيد التابع 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()‎ في توثيق أردوينو الرسمي.

@@ سطر 14: / سطر 14: @@
 ==القيم المعادة==
 يعاد فهرس القيمة <code>val</code> التي عثر عليها ضمن [[Arduino/stringobject|السلسلة النصية]] المعطاة، أو تعاد القيمة 1- إن لم يُعثَر على تلك القيمة.
+==أمثلة==
+مثال على استعمال الدالة <code>indexOf()‎</code>:<syntaxhighlight lang="arduino">
+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
+}
+</syntaxhighlight>
 ==انظر أيضًا==
-* التابع <code>[[Arduino/stringobject/charat|charAt()‎]]</code>: يجلب محرفًا ذا فهرس محدَّد من السلسلة النصية التي استدعيت معها.
+*التابع <code>[[Arduino/stringobject/charat|charAt()‎]]</code>: يجلب محرفًا ذا فهرس محدَّد من السلسلة النصية التي استدعيت معها.
-* التابع <code>[[Arduino/stringobject/getbytes|getBytes()‎]]</code>: يجلب عددًا محدَّدًا من بايتات السلسلة النصية التي استدعيت معه ويضعه في مخزَّن معيَّن.
+*التابع <code>[[Arduino/stringobject/getbytes|getBytes()‎]]</code>: يجلب عددًا محدَّدًا من بايتات السلسلة النصية التي استدعيت معه ويضعه في مخزَّن معيَّن.
-* التابع <code>[[Arduino/stringobject/lastindexof|lastIndexOf()]]‎</code>: تعيد فهرس آخر ظهور لمحرف أو سلسلة نصية معيَّنة ضمن السلسلة النصية التي استدعيت معه.
+*التابع <code>[[Arduino/stringobject/lastindexof|lastIndexOf()]]‎</code>: تعيد فهرس آخر ظهور لمحرف أو سلسلة نصية معيَّنة ضمن السلسلة النصية التي استدعيت معه.
-* التابع <code>[[Arduino/stringobject/length|length()‎]]</code>: يعيد عدد محارف السلسلة النصية التي استدعيت معه.
+*التابع <code>[[Arduino/stringobject/length|length()‎]]</code>: يعيد عدد محارف السلسلة النصية التي استدعيت معه.
-* التابع <code>[[Arduino/stringobject/replace|replace()‎]]</code>: يبدِّل [[Arduino/char|محرفًا]] أو سلسلةً نصيةً فرعيةً مكان محرف أو سلسلة نصية فرعية محدَّدة موجودة في السلسلة النصية التي استدعيت معه.
+*التابع <code>[[Arduino/stringobject/replace|replace()‎]]</code>: يبدِّل [[Arduino/char|محرفًا]] أو سلسلةً نصيةً فرعيةً مكان محرف أو سلسلة نصية فرعية محدَّدة موجودة في السلسلة النصية التي استدعيت معه.
-* التابع <code>[[Arduino/stringobject/substring|substring()‎]]</code>: يجلب جزءًا محدَّدًا من [[Arduino/stringobject|السلسلة النصية]] التي استدعيت معه.
+*التابع <code>[[Arduino/stringobject/substring|substring()‎]]</code>: يجلب جزءًا محدَّدًا من [[Arduino/stringobject|السلسلة النصية]] التي استدعيت معه.
 ==مصادر==
 *[https://www.arduino.cc/reference/en/language/variables/data-types/string/functions/indexof/ صفحة التابع indexOf()‎ في توثيق أردوينو الرسمي.]