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

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