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

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

يحذف التابع remove()‎ عددًا محدَّدًا من محارف السلسلة النصية التي استدعيت معها. انتبه إلى أنَّ هذه الدالة تعدِّل نفس السلسلة النصية المعطاة، لذا كن حذرًا عند استعمالها.

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

string.remove(index)

string.remove(index, count)

تمثِّل string السلسلة النصية التي يراد حذف محارفها التي تبدأ عند المحرف ذي الفهرس index وحتى نهاية السلسلة أو بعدد المحارف count فقط.

المعاملات

`index`

عددٌ صحيحٌ عديم الإشارة يمثِّل فهرس بداية المحارف المراد حذفها.

`count`

عددٌ صحيحٌ عديم الإشارة يمثِّل عدد العناصر المراد حذفها بدءًا من المحرف ذي الفهرس index. هذا المعامل اختياري، وستُحذَف العناصر بدءًا من العنصر ذي الفهرس index وحتى نهاية السلسلة النصية إن لم يُعطَ.

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

لا يعاد أي شيء.

أمثلة

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

String stringValue = "wiki Hsoub";

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

void loop() {
  stringValue.remove(0, 1);
  Serial.println(stringValue); // iki Hsoub
  stringValue.remove(4);
  Serial.println(stringValue); // iki
}

انظر أيضًا

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

مصادر

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

@@ سطر 1: / سطر 1: @@
-تحذف الدالة <code>remove()‎</code> عددًا محدَّدًا من محارف السلسلة النصية التي استدعيت معها. انتبه إلى أنَّ هذه الدالة تعدِّل نفس السلسلة النصية المعطاة، لذا كن حذرًا عند استعمالها.
+<noinclude>{{DISPLAYTITLE:التابع <code>String.remove()‎</code> في أردوينو}}</noinclude>
+يحذف التابع <code>remove()‎</code> عددًا محدَّدًا من محارف السلسلة النصية التي استدعيت معها. انتبه إلى أنَّ هذه الدالة تعدِّل نفس السلسلة النصية المعطاة، لذا كن حذرًا عند استعمالها.
-== البنية العامة ==
+==البنية العامة==
 <syntaxhighlight lang="arduino">
 string.remove(index)
@@ سطر 7: / سطر 7: @@
 string.remove(index, count)
 </syntaxhighlight>تمثِّل <code>string</code> السلسلة النصية التي يراد حذف محارفها التي تبدأ عند المحرف ذي الفهرس <code>index</code> وحتى نهاية السلسلة أو بعدد المحارف <code>count</code> فقط.
+==المعاملات==
+===<code>index</code>===
+[[Arduino/unsignedint|عددٌ صحيحٌ عديم الإشارة]] يمثِّل فهرس بداية المحارف المراد حذفها.
+===<code>count</code>===
+[[Arduino/unsignedint|عددٌ صحيحٌ عديم الإشارة]] يمثِّل عدد العناصر المراد حذفها بدءًا من المحرف ذي الفهرس <code>index</code>. هذا المعامل اختياري، وستُحذَف العناصر بدءًا من العنصر ذي الفهرس <code>index</code> وحتى نهاية السلسلة النصية إن لم يُعطَ.
+==القيم المعادة==
+لا يعاد أي شيء.
+==أمثلة==
+مثال على استعمال التابع <code>remove()‎</code>:<syntaxhighlight lang="arduino">
+String stringValue = "wiki Hsoub";
-== المعاملات ==
+void setup() {
+  Serial.begin(9600);
-=== <code>index</code> ===
+}
-عددٌ صحيحٌ عديم الإشارة يمثِّل فهرس بداية المحارف المراد حذفها.
-=== <code>count</code> ===
-عددٌ صحيح عديم الإشارة يمثِّل عدد العناصر المراد حذفها بدءًا من المحرف ذي الفهرس <code>index</code>. هذا المعامل اختياري، وستُحذَف العناصر بدءًا من العنصر ذي الفهرس <code>index</code> وحتى نهاية السلسلة النصية إن لم يُعطَ.
-== القيم المعادة ==
-لا يعاد أي شيء.
-== انظر أيضًا ==
+void loop() {
+  stringValue.remove(0, 1);
+  Serial.println(stringValue); // iki Hsoub
+  stringValue.remove(4);
+  Serial.println(stringValue); // iki
+}
+</syntaxhighlight>
+==انظر أيضًا==
+* التابع <code>[[Arduino/stringobject/substring|substring()‎]]</code>: يجلب جزءًا محدَّدًا من <nowiki/>[[Arduino/stringobject|السلسلة النصية]] التي استدعيت معه.
+* التابع <code>[[Arduino/stringobject/replace|replace()‎]]</code>: يبدِّل <nowiki/>[[Arduino/char|محرفًا]] أو سلسلةً نصيةً فرعيةً مكان محرف أو سلسلة نصية فرعية محدَّدة موجودة في السلسلة النصية التي استدعيت معه.
+* التابع <code>[[Arduino/stringobject/reserve|reserve()]]‎</code>: يحجز جزءًا من الذاكرة وتخصِّصه للتلاعب <nowiki/>[[Arduino/stringobject|بالسلسلة النصية]] التي استدعيت معه وتعديلها.
+* التابع <code>[[Arduino/stringobject/setcharat|setCharAt()‎]]</code>: يعيِّن قيمة <nowiki/>[[Arduino/char|محرفٍ]] متوضِّع في <nowiki/>[[Arduino/stringobject|السلسلة النصية]] التي استدعيت معه إلى <nowiki/>[[Arduino/char|المحرف]] المُمرَّر إليه.
+* التابع <code>[[Arduino/stringobject/trim|trim()‎]]</code>: يزيل جميع المسافات البيضاء من بداية ونهاية السلسلة النصية التي استدعيت معه.
-== مصادر ==
+==مصادر==
-* [https://www.arduino.cc/reference/en/language/variables/data-types/string/functions/remove/ صفحة الدالة remove()‎ في توثيق أردوينو الرسمي.]
+*[https://www.arduino.cc/reference/en/language/variables/data-types/string/functions/remove/ صفحة التابع remove()‎ في توثيق أردوينو الرسمي.]
+[[تصنيف: Arduino]]
+[[تصنيف: Arduino Method]]
+[[تصنيف: Arduino String]]