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

من موسوعة حسوب
أنشأ الصفحة ب'تعيد الدالة <code>indexOf()‎</code> فهرس أول ظهور لمحرف أو سلسلة نصية معيَّنة ضمن السلسلة النصية التي...'
 
إضافة محتويات الصفحة.
سطر 1: سطر 1:
تعيد الدالة <code>indexOf()‎</code> فهرس أول ظهور لمحرف أو سلسلة نصية معيَّنة ضمن السلسلة النصية التي استدعيت معها. تبحث الدالة ابتداءً من بداية السلسلة النصية المعطاة افتراضيًّا، ولكن يمكن بدء البحث من أي موضع ضمن السلسلة النصية.
<noinclude>{{DISPLAYTITLE:التابع <code>String.indexOf()‎</code> في أردوينو}}</noinclude>
 
يعيد التابع <code>indexOf()‎</code> فهرس أول ظهور لمحرف أو سلسلة نصية معيَّنة ضمن السلسلة النصية التي استدعيت معه. يبحث التابع ابتداءً من بداية [[Arduino/stringobject|السلسلة النصية]] المعطاة افتراضيًّا، ولكن يمكن بدء البحث من أي موضع ضمن [[Arduino/stringobject|السلسلة النصية]].
== البنية العامة ==
==البنية العامة==
<syntaxhighlight lang="arduino">
<syntaxhighlight lang="arduino">
string.indexOf(val)
string.indexOf(val)


string.indexOf(val, from)
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 (أي البحث بدءًا من المحرف الأول).
فهرس المحرف الذي يراد بدء عملية البحث عنده. القيمة الافتراضية له هي: 0 (أي البحث بدءًا من المحرف الأول).
==القيم المعادة==
يعاد فهرس القيمة <code>val</code> التي عثر عليها ضمن [[Arduino/stringobject|السلسلة النصية]] المعطاة، أو تعاد القيمة 1- إن لم يُعثَر على تلك القيمة.
==انظر أيضًا==
* التابع <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|السلسلة النصية]] التي استدعيت معه.
يعاد فهرس القيمة <code>val</code> التي عثر عليها ضمن السلسلة النصية المعطاة، أو تعاد القيمة 1- إن لم يُعثَر على تلك القيمة.
 
== انظر أيضًا ==


== مصادر ==
==مصادر==
* [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]]

مراجعة 09:08، 30 أكتوبر 2018

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

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

string.indexOf(val)

string.indexOf(val, from)

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

المعاملات

val

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

from

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

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

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

انظر أيضًا

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

مصادر