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

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

يبدِّل التابع replace()‎ محرفًا أو سلسلةً نصيةً فرعيةً مكان محرف أو سلسلة نصية فرعية محدَّدة موجودة في السلسلة النصية التي استدعيت معه.

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

string.replace(substring1, substring2)

تمثِّل string السلسلة النصية التي يراد تبديل قيمة المعامل substring2 مكان قيمة المعامل substring1 أينما وجدت فيها.

المعاملات

`substring1`

القيمة التي يراد استبدال قيمة أخرى بها. يمكن أن يكون هذا المعامل محرفًا أو سلسلةً نصيةً فرعيةً.

`substring2`

القيمة التي ستحل مكان قيمة المعامل substring1 أينما وُجدَت في السلسلة النصية المعطاة.

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

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

أمثلة

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

String stringValue = "wiki Hsoub";

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

void loop() {
  stringValue.replace("wiki", "academy");
  Serial.println(stringValue); // academy Hsoub
  stringValue.replace('a', '2');
  Serial.println(stringValue); // 2c2demy Hsoub
}

انظر أيضًا

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

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

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

مصادر

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

@@ سطر 1: / سطر 1: @@
-تبدِّل الدالة <code>replace()‎</code> [[Arduino/char|محرفًا]] أو سلسلةً نصيةً فرعيةً مكان محرف أو سلسلة نصية فرعية محدَّدة موجودة في السلسلة النصية التي استدعيت معها.
+<noinclude>{{DISPLAYTITLE:التابع <code>String.replace()‎</code> في أردوينو}}</noinclude>
+يبدِّل التابع <code>replace()‎</code> [[Arduino/char|محرفًا]] أو سلسلةً نصيةً فرعيةً مكان محرف أو سلسلة نصية فرعية محدَّدة موجودة في السلسلة النصية التي استدعيت معه.
 ==البنية العامة==
 <syntaxhighlight lang="arduino">
 string.replace(substring1, substring2)
-</syntaxhighlight>تمثِّل <code>string</code> السلسلة النصية التي يراد تبديل قيمة المعامل <code>substring2</code> مكان قيمة المعامل <code>substring1</code> أينما وجدت فيها.
+</syntaxhighlight>تمثِّل <code>string</code> [[Arduino/stringobject|السلسلة النصية]] التي يراد تبديل قيمة المعامل <code>substring2</code> مكان قيمة المعامل <code>substring1</code> أينما وجدت فيها.
 ==المعاملات==
 ===<code>substring1</code>===
 القيمة التي يراد استبدال قيمة أخرى بها. يمكن أن يكون هذا المعامل [[Arduino/char|محرفًا]] أو سلسلةً نصيةً فرعيةً.
 ===<code>substring2</code>===
-القيمة التي ستحل مكان قيمة المعامل <code>substring1</code> أينما وُجدَت في السلسلة النصية المعطاة.
+القيمة التي ستحل مكان قيمة المعامل <code>substring1</code> أينما وُجدَت في [[Arduino/stringobject|السلسلة النصية]] المعطاة.
 ==القيم المعادة==
 لا يعاد أي شيء.
+==أمثلة==
+مثال على استعمال التابع <code>replace()‎</code>:<syntaxhighlight lang="arduino">
+String stringValue = "wiki Hsoub";
+void setup() {
+  Serial.begin(9600);
+}
+void loop() {
+  stringValue.replace("wiki", "academy");
+  Serial.println(stringValue); // academy Hsoub
+  stringValue.replace('a', '2');
+  Serial.println(stringValue); // 2c2demy Hsoub
+}
+</syntaxhighlight>
 ==انظر أيضًا==
+* التابع <code>[[Arduino/stringobject/charat|charAt()‎]]</code>: يجلب محرفًا ذا فهرس محدَّد من السلسلة النصية التي استدعيت معها.
+* التابع <code>[[Arduino/stringobject/compareto|compareTo()‎]]</code>: يوازن بين سلسلتين نصيتين ويحدِّد أيهما أكبر من الأخرى أو إن كانتا متساويتين.
+* التابع <code>[[Arduino/stringobject/equals|equals()‎]]</code>: يتحقَّق إن كانت السلسلة النصية التي استدعيت معه مساويةً للسلسلة النصية التي مُرِّرت إليه.
+* التابع <code>[[Arduino/stringobject/getbytes|getBytes()‎]]</code>: يجلب عددًا محدَّدًا من بايتات السلسلة النصية التي استدعيت معه ويضعه في مخزَّن معيَّن.
+* التابع <code>[[Arduino/stringobject/setcharat|setCharAt()‎]]</code>: يعيِّن قيمة [[Arduino/char|محرفٍ]] متوضِّع في [[Arduino/stringobject|السلسلة النصية]] التي استدعيت معه إلى [[Arduino/char|المحرف]] المُمرَّر إليه.
+* التابع <code>[[Arduino/stringobject/startswith|startsWith()‎]]</code>: تتحقَّق إن كانت السلسلة النصية التي استدعيت معه تبدأ بالمحارف نفسها التي مُرِّرت إليه.
+* التابع <code>[[Arduino/stringobject/substring|substring()‎]]</code>: يجلب جزءًا محدَّدًا من [[Arduino/stringobject|السلسلة النصية]] التي استدعيت معه.
+* التابع <code>[[Arduino/stringobject/trim|trim()‎]]</code>: يزيل جميع المسافات البيضاء من بداية ونهاية السلسلة النصية التي استدعيت معه.
 ==مصادر==
-*[https://www.arduino.cc/reference/en/language/variables/data-types/string/functions/replace/ صفحة الدالة replace()‎ في توثيق أردوينو الرسمي.]
+*[https://www.arduino.cc/reference/en/language/variables/data-types/string/functions/replace/ صفحة التابع replace()‎ في توثيق أردوينو الرسمي.]
+[[تصنيف: Arduino]]
+[[تصنيف: Arduino Method]]
+[[تصنيف: Arduino String]]