عرض مصدر Arduino/stringobject/substring

<noinclude>{{DISPLAYTITLE:التابع <code>String.substring()‎</code> في أردوينو}}</noinclude>
يجلب التابع <code>substring()‎</code> جزءًا محدَّدًا من [[Arduino/stringobject|السلسلة النصية]] التي استدعيت معه.
==البنية العامة==
<syntaxhighlight lang="arduino">
string.substring(from)

string.substring(from, to)
</syntaxhighlight>تمثِّل <code>string</code> [[Arduino/stringobject|السلسلة النصية]] التي سيُجلَب منها الجزء المحدَّد بالمعامل <code>from</code> وحتى نهاية السلسلة أو حتى المعامل <code>to</code> إن أعطي.
==المعاملات==
===<code>from</code>===
فهرس [[Arduino/char|المحرف]] الذي يحدِّد بداية الجزء المراد جلبه من [[Arduino/stringobject|السلسلة النصية]]. يدخل هذا [[Arduino/char|المحرف]] ضمن المجال المعاد.
===<code>to</code>===
فهرس [[Arduino/char|المحرف]] الذي يحدِّد نهاية الجزء المراد جلبه من [[Arduino/stringobject|السلسلة النصية]]. لا يدخل هذا المعامل ضمن المجال المعاد. هذا المعامل اختياري؛ إن لم يُعطَ، سيُعاد الجزء المحدَّد [[Arduino/char|بالمحرف]] ذي الفهرس <code>from</code> وحتى نهاية [[Arduino/stringobject|السلسلة النصية]].
==القيم المعادة==
تعاد [[Arduino/stringobject|السلسلة النصية الفرعية]] المحدَّدة بالمجال الواقع بين [[Arduino/char|المحرف]] ذي الفهرس <code>from</code> ونهاية السلسلة النصية أو [[Arduino/char|المحرف]] ذي الفهرس <code>to</code> (إن أعطي).
==أمثلة==
مثال على استعمال التابع <code>substring()‎</code>:<syntaxhighlight lang="arduino">
String stringValue = "Wiki wiki wiki Hsoub";

void setup() {
  Serial.begin(9600);
}

void loop() {
  Serial.println(stringValue.substring(5));    // wiki wiki Hsoub
  Serial.println(stringValue.substring(2, 5)); // ki
}
</syntaxhighlight>
==انظر أيضًا==
* التابع <code>[[Arduino/stringobject/charat|charAt()‎]]</code>: يجلب محرفًا ذا فهرس محدَّد من السلسلة النصية التي استدعيت معها.
* التابع <code>[[Arduino/stringobject/concat|concat()‎]]</code>: يضيف المعامل المُمرَّر إليها إلى السلسلة النصية التي استدعيت معه.
* التابع <code>[[Arduino/stringobject/getbytes|getBytes()‎]]</code>: يجلب عددًا محدَّدًا من بايتات السلسلة النصية التي استدعيت معه ويضعه في مخزَّن معيَّن.
* التابع <code>[[Arduino/stringobject/replace|replace()‎]]</code>: يبدِّل [[Arduino/char|محرفًا]] أو سلسلةً نصيةً فرعيةً مكان محرف أو سلسلة نصية فرعية محدَّدة موجودة في السلسلة النصية التي استدعيت معه.
* التابع <code>[[Arduino/stringobject/setcharat|setCharAt()‎]]</code>: يعيِّن قيمة [[Arduino/char|محرفٍ]] متوضِّع في [[Arduino/stringobject|السلسلة النصية]] التي استدعيت معه إلى [[Arduino/char|المحرف]] المُمرَّر إليه.

* التابع <code>[[Arduino/stringobject/startswith|startsWith()‎]]</code>: تتحقَّق إن كانت السلسلة النصية التي استدعيت معه تبدأ بالمحارف نفسها التي مُرِّرت إليه.
* التابع <code>[[Arduino/stringobject/trim|trim()‎]]</code>: يزيل جميع المسافات البيضاء من بداية ونهاية السلسلة النصية التي استدعيت معه.

==مصادر==
*[https://www.arduino.cc/reference/en/language/variables/data-types/string/functions/substring/ صفحة التابع substring()‎ في توثيق أردوينو الرسمي.]
[[تصنيف: Arduino]]
[[تصنيف: Arduino Method]]
[[تصنيف: Arduino String]]