الفرق بين المراجعتين ل"Arduino/stringobject/remove"
< Arduino | stringobject
اذهب إلى التنقل
اذهب إلى البحث
جميل-بيلوني (نقاش | مساهمات) (أنشأ الصفحة ب'تحذف الدالة <code>remove()</code> عددًا محدَّدًا من محارف السلسلة النصية التي استدعيت معها. انتبه إل...') |
جميل-بيلوني (نقاش | مساهمات) (إضافة مثال.) |
||
| (مراجعتان متوسطتان بواسطة نفس المستخدم غير معروضتين) | |||
| سطر 1: | سطر 1: | ||
| − | + | <noinclude>{{DISPLAYTITLE:التابع <code>String.remove()</code> في أردوينو}}</noinclude> | |
| − | + | يحذف التابع <code>remove()</code> عددًا محدَّدًا من محارف السلسلة النصية التي استدعيت معها. انتبه إلى أنَّ هذه الدالة تعدِّل نفس السلسلة النصية المعطاة، لذا كن حذرًا عند استعمالها. | |
| − | == البنية العامة == | + | ==البنية العامة== |
<syntaxhighlight lang="arduino"> | <syntaxhighlight lang="arduino"> | ||
string.remove(index) | string.remove(index) | ||
| سطر 7: | سطر 7: | ||
string.remove(index, count) | string.remove(index, count) | ||
</syntaxhighlight>تمثِّل <code>string</code> السلسلة النصية التي يراد حذف محارفها التي تبدأ عند المحرف ذي الفهرس <code>index</code> وحتى نهاية السلسلة أو بعدد المحارف <code>count</code> فقط. | </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); | |
| − | + | } | |
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | == انظر أيضًا == | + | 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/ صفحة | + | *[https://www.arduino.cc/reference/en/language/variables/data-types/string/functions/remove/ صفحة التابع remove() في توثيق أردوينو الرسمي.] |
| + | [[تصنيف: Arduino]] | ||
| + | [[تصنيف: Arduino Method]] | ||
| + | [[تصنيف: Arduino String]] | ||
المراجعة الحالية بتاريخ 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(): يزيل جميع المسافات البيضاء من بداية ونهاية السلسلة النصية التي استدعيت معه.