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

المراجعة الحالية بتاريخ 06:00، 7 نوفمبر 2018

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

@@ سطر 1: / سطر 1: @@
-تجلب الدالة <code>substring()‎</code> جزءًا محدَّدًا من [[Arduino/stringobject|السلسلة النصية]] التي استدعيت معها.
+<noinclude>{{DISPLAYTITLE:التابع <code>String.substring()‎</code> في أردوينو}}</noinclude>
+يجلب التابع <code>substring()‎</code> جزءًا محدَّدًا من [[Arduino/stringobject|السلسلة النصية]] التي استدعيت معه.
 ==البنية العامة==
 <syntaxhighlight lang="arduino">
@@ سطر 7: / سطر 7: @@
 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";
-=== <code>to</code> ===
+void setup() {
-فهرس [[Arduino/char|المحرف]] الذي يحدِّد نهاية الجزء المراد جلبه من [[Arduino/stringobject|السلسلة النصية]]. لا يدخل هذا المعامل ضمن المجال المعاد. هذا المعامل اختياري؛ إن لم يُعطَ، سيعاد الجزء المحدَّد [[Arduino/char|بالمحرف]] ذي الفهرس <code>from</code> وحتى نهاية [[Arduino/stringobject|السلسلة النصية]].
+  Serial.begin(9600);
+}
-==القيم المعادة==
+void loop() {
-تعاد [[Arduino/stringobject|السلسلة النصية الفرعية]] المحدَّدة بالمجال الواقع بين [[Arduino/char|المحرف]] ذي الفهرس <code>from</code> ونهاية السلسلة النصية أو [[Arduino/char|المحرف]] ذي الفهرس <code>to</code> (إن أعطي).
+  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()‎ في توثيق أردوينو الرسمي.]
+*[https://www.arduino.cc/reference/en/language/variables/data-types/string/functions/substring/ صفحة التابع substring()‎ في توثيق أردوينو الرسمي.]
+[[تصنيف: Arduino]]
+[[تصنيف: Arduino Method]]
+[[تصنيف: Arduino String]]