الفرق بين المراجعتين ل"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()‎ في توثيق أردوينو الرسمي.

@@ سطر 1: / سطر 1: @@
-تضيف الدالة <code>concat()‎</code> المعامل المُمرَّر إليها إلى السلسلة النصية التي استدعيت معها.
+<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>parameter</code>''' ===
+==القيم المعادة==
-القيمة المراد إضافتها إلى السلسلة النصية المعطاة. أنواع البيانات المسموح بها هي: الكائن <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
-* [https://www.arduino.cc/reference/en/language/variables/data-types/string/functions/concat/ صفحة الدالة concat()‎ في توثيق أردوينو الرسمي.]
+}
+</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]]