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

المراجعة الحالية بتاريخ 22:04، 6 نوفمبر 2018

يضيف التابع concat()‎ المعامل المُمرَّر إليه إلى السلسلة النصية التي استدعيت معه.

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

string.concat(parameter)

تمثِّل string السلسلة النصية المراد إضافة قيمة المعامل parameter إليها.

المعاملات

`parameter`

القيمة المراد إضافتها إلى السلسلة النصية المعطاة. أنواع البيانات المسموح بها هي: الكائن String، وسلسلة نصية، ومحرف، وبايت، وعدد صحيح، وعدد صحيح عديم الإشارة، وعدد طويل، وعدد طويل عديم الإشارة، وعدد عشري، وعدد عشري مضاعف، و ‎__FlashStringHelper(F() macro)‎.

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

تعاد القيمة true المنطقية إن نجحت العملية، أو القيمة false إن فشلت العملية ولم تتغير السلسلة string.

أمثلة

مثال على استعمال الدالة concat()‎:

String stringValue = "wiki";
void setup() {
   Serial.begin(9600);
}

void loop() {
  stringValue1.concat(" Hsoub");
  Serial.println(stringValue1); // wiki Hsoub
}

انظر أيضًا

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

مصادر

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

@@ سطر 11: / سطر 11: @@
 ==القيم المعادة==
 تعاد القيمة <code>[[Arduino/constants#.D8.A7.D9.84.D8.AB.D8.A7.D8.A8.D8.AA true|true]]</code> المنطقية إن نجحت العملية، أو القيمة <code>[[Arduino/constants#.D8.A7.D9.84.D8.AB.D8.A7.D8.A8.D8.AA false|false]]</code> إن فشلت العملية ولم تتغير السلسلة <code>string</code>.
+==أمثلة==
+مثال على استعمال الدالة <code>concat()‎</code>:<syntaxhighlight lang="arduino">
+String stringValue = "wiki";
+void setup() {
+   Serial.begin(9600);
+}
+void loop() {
+  stringValue1.concat(" Hsoub");
+  Serial.println(stringValue1); // wiki Hsoub
+}
+</syntaxhighlight>
 ==انظر أيضًا==
-* التابع <code>[[Arduino/stringobject/charat|charAt()‎]]</code>: يجلب محرفًا ذا فهرس محدَّد من السلسلة النصية التي استدعيت معها.
+*التابع <code>[[Arduino/stringobject/charat|charAt()‎]]</code>: يجلب محرفًا ذا فهرس محدَّد من السلسلة النصية التي استدعيت معها.
-* التابع <code>[[Arduino/stringobject/endswith|endsWith()‎]]</code>: يتحقَّق إن كانت السلسلة النصية التي استدعيت معه تنتهي بالمحارف نفسها التي مُرِّرت إليه.
+*التابع <code>[[Arduino/stringobject/endswith|endsWith()‎]]</code>: يتحقَّق إن كانت السلسلة النصية التي استدعيت معه تنتهي بالمحارف نفسها التي مُرِّرت إليه.
-* التابع <code>[[Arduino/stringobject/equals|equals()‎]]</code>: يتحقَّق إن كانت السلسلة النصية التي استدعيت معه مساويةً للسلسلة النصية التي مُرِّرت إليه.
+*التابع <code>[[Arduino/stringobject/equals|equals()‎]]</code>: يتحقَّق إن كانت السلسلة النصية التي استدعيت معه مساويةً للسلسلة النصية التي مُرِّرت إليه.
-* التابع <code>[[Arduino/stringobject/getbytes|getBytes()‎]]</code>: يجلب عددًا محدَّدًا من بايتات السلسلة النصية التي استدعيت معه ويضعه في مخزَّن معيَّن.
+*التابع <code>[[Arduino/stringobject/getbytes|getBytes()‎]]</code>: يجلب عددًا محدَّدًا من بايتات السلسلة النصية التي استدعيت معه ويضعه في مخزَّن معيَّن.
-* التابع <code>[[Arduino/stringobject/indexof|indexOf()‎]]</code>: يعيد فهرس أول ظهور لمحرف أو سلسلة نصية معيَّنة ضمن السلسلة النصية التي استدعيت معه.
+*التابع <code>[[Arduino/stringobject/indexof|indexOf()‎]]</code>: يعيد فهرس أول ظهور لمحرف أو سلسلة نصية معيَّنة ضمن السلسلة النصية التي استدعيت معه.
-* التابع <code>[[Arduino/stringobject/replace|replace()‎]]</code>: يبدِّل [[Arduino/char|محرفًا]] أو سلسلةً نصيةً فرعيةً مكان محرف أو سلسلة نصية فرعية محدَّدة موجودة في السلسلة النصية التي استدعيت معه.
+*التابع <code>[[Arduino/stringobject/replace|replace()‎]]</code>: يبدِّل [[Arduino/char|محرفًا]] أو سلسلةً نصيةً فرعيةً مكان محرف أو سلسلة نصية فرعية محدَّدة موجودة في السلسلة النصية التي استدعيت معه.
-* التابع <code>[[Arduino/stringobject/reserve|reserve()]]‎</code>: يحجز جزءًا من الذاكرة وتخصِّصه للتلاعب [[Arduino/stringobject|بالسلسلة النصية]] التي استدعيت معه وتعديلها.
+*التابع <code>[[Arduino/stringobject/reserve|reserve()]]‎</code>: يحجز جزءًا من الذاكرة وتخصِّصه للتلاعب [[Arduino/stringobject|بالسلسلة النصية]] التي استدعيت معه وتعديلها.
-* التابع <code>[[Arduino/stringobject/setcharat|setCharAt()‎]]</code>: يعيِّن قيمة [[Arduino/char|محرفٍ]] متوضِّع في [[Arduino/stringobject|السلسلة النصية]] التي استدعيت معه إلى [[Arduino/char|المحرف]] المُمرَّر إليه.
+*التابع <code>[[Arduino/stringobject/setcharat|setCharAt()‎]]</code>: يعيِّن قيمة [[Arduino/char|محرفٍ]] متوضِّع في [[Arduino/stringobject|السلسلة النصية]] التي استدعيت معه إلى [[Arduino/char|المحرف]] المُمرَّر إليه.
 ==مصادر==
 *[https://www.arduino.cc/reference/en/language/variables/data-types/string/functions/concat/ صفحة التابع concat()‎ في توثيق أردوينو الرسمي.]