عرض مصدر Arduino/stringobject/concat

<noinclude>{{DISPLAYTITLE:التابع <code>String.concat()‎</code> في أردوينو}}</noinclude>
يضيف التابع <code>concat()‎</code> المعامل المُمرَّر إليه إلى السلسلة النصية التي استدعيت معه.
==البنية العامة==
<syntaxhighlight lang="arduino">
string.concat(parameter)

</syntaxhighlight>تمثِّل <code>string</code> السلسلة النصية المراد إضافة قيمة المعامل <code>parameter</code> إليها.
==المعاملات==
==='''<code>parameter</code>'''===
القيمة المراد إضافتها إلى [[Arduino/stringobject|السلسلة النصية]] المعطاة. أنواع البيانات المسموح بها هي: الكائن <code>[[Arduino/stringobject|String]]</code>، و<nowiki/>[[Arduino/string|سلسلة نصية]]، و<nowiki/>[[Arduino/char|محرف]]، و<nowiki/>[[Arduino/byte|بايت]]، و<nowiki/>[[Arduino/int|عدد صحيح]]، و<nowiki/>[[Arduino/unsignedint|عدد صحيح عديم الإشارة]]، و<nowiki/>[[Arduino/long|عدد طويل]]، و<nowiki/>[[Arduino/unsignedlong|عدد طويل عديم الإشارة]]، و<nowiki/>[[Arduino/float|عدد عشري]]، و<nowiki/>[[Arduino/double|عدد عشري مضاعف]]، و <code>‎__FlashStringHelper([[Arduino/progmem#.D8.A7.D9.84.D8.A7.D8.B3.D8.AA.D8.AF.D8.B9.D8.A7.D8.A1 F.28.29.E2.80.8E .D8.A7.D9.84.D9.85.D9.88.D8.B3.D9.8E.D9.91.D8.B9|F() macro]])‎</code>.
==القيم المعادة==
تعاد القيمة <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/endswith|endsWith()‎]]</code>: يتحقَّق إن كانت السلسلة النصية التي استدعيت معه تنتهي بالمحارف نفسها التي مُرِّرت إليه.
*التابع <code>[[Arduino/stringobject/equals|equals()‎]]</code>: يتحقَّق إن كانت السلسلة النصية التي استدعيت معه مساويةً للسلسلة النصية التي مُرِّرت إليه.
*التابع <code>[[Arduino/stringobject/getbytes|getBytes()‎]]</code>: يجلب عددًا محدَّدًا من بايتات السلسلة النصية التي استدعيت معه ويضعه في مخزَّن معيَّن.
*التابع <code>[[Arduino/stringobject/indexof|indexOf()‎]]</code>: يعيد فهرس أول ظهور لمحرف أو سلسلة نصية معيَّنة ضمن السلسلة النصية التي استدعيت معه.
*التابع <code>[[Arduino/stringobject/replace|replace()‎]]</code>: يبدِّل [[Arduino/char|محرفًا]] أو سلسلةً نصيةً فرعيةً مكان محرف أو سلسلة نصية فرعية محدَّدة موجودة في السلسلة النصية التي استدعيت معه.
*التابع <code>[[Arduino/stringobject/reserve|reserve()]]‎</code>: يحجز جزءًا من الذاكرة وتخصِّصه للتلاعب [[Arduino/stringobject|بالسلسلة النصية]] التي استدعيت معه وتعديلها.
*التابع <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()‎ في توثيق أردوينو الرسمي.]
[[تصنيف: Arduino]]
[[تصنيف: Arduino Method]]
[[تصنيف: Arduino String]]