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

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

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

string.substring(from)

string.substring(from, to)

تمثِّل string السلسلة النصية التي سيُجلَب منها الجزء المحدَّد بالمعامل from وحتى نهاية السلسلة أو حتى المعامل to إن أعطي.

المعاملات

from

فهرس المحرف الذي يحدِّد بداية الجزء المراد جلبه من السلسلة النصية. يدخل هذا المحرف ضمن المجال المعاد.

to

فهرس المحرف الذي يحدِّد نهاية الجزء المراد جلبه من السلسلة النصية. لا يدخل هذا المعامل ضمن المجال المعاد. هذا المعامل اختياري؛ إن لم يُعطَ، سيُعاد الجزء المحدَّد بالمحرف ذي الفهرس from وحتى نهاية السلسلة النصية.

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

تعاد السلسلة النصية الفرعية المحدَّدة بالمجال الواقع بين المحرف ذي الفهرس from ونهاية السلسلة النصية أو المحرف ذي الفهرس to (إن أعطي).

أمثلة

مثال على استعمال التابع substring()‎:

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
}

انظر أيضًا

• التابع charAt()‎: يجلب محرفًا ذا فهرس محدَّد من السلسلة النصية التي استدعيت معها.
• التابع concat()‎: يضيف المعامل المُمرَّر إليها إلى السلسلة النصية التي استدعيت معه.
• التابع getBytes()‎: يجلب عددًا محدَّدًا من بايتات السلسلة النصية التي استدعيت معه ويضعه في مخزَّن معيَّن.
• التابع replace()‎: يبدِّل محرفًا أو سلسلةً نصيةً فرعيةً مكان محرف أو سلسلة نصية فرعية محدَّدة موجودة في السلسلة النصية التي استدعيت معه.
• التابع setCharAt()‎: يعيِّن قيمة محرفٍ متوضِّع في السلسلة النصية التي استدعيت معه إلى المحرف المُمرَّر إليه.

• التابع startsWith()‎: تتحقَّق إن كانت السلسلة النصية التي استدعيت معه تبدأ بالمحارف نفسها التي مُرِّرت إليه.
• التابع trim()‎: يزيل جميع المسافات البيضاء من بداية ونهاية السلسلة النصية التي استدعيت معه.

مصادر

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