Arduino/stringobject/reserve

يحجز التابع reserve()‎ جزءًا من الذاكرة ويخصِّصه للتلاعب بالسلسلة النصية التي استدعيت معه وتعديلها.

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

string.reserve(size)

تمثِّل string السلسلة النصية التي سيُحجَز لها جزءٌ من الذاكرة بحجم size.

المعاملات

size

عدد صحيح عديم الإشارة يحدِّد عدد البايتات المراد حجزها من الذاكرة وتخصيصها لعمليات التلاعب بالسلسلة النصية المعطاة والتعديل عليها.

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

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

أمثلة

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

String myString;

void setup() {
  // تهيئة منفذ الاتصال التسلسلي وبدئه
  Serial.begin(9600);
  while (!Serial) {
    ; // انتظار المنفذ التسلسلي لكي يتصل
  }

  myString.reserve(26);
  myString = "i=";
  myString += "1234";
  myString += ", is that ok?";

  // myString طباعة السلسلة النصية
  Serial.println(myString);
}

void loop() {
 // افعل شيئًا هنا
}

انظر أيضًا

• التابع concat()‎: يضيف المعامل المُمرَّر إليها إلى السلسلة النصية التي استدعيت معه.
• التابع c_str()‎: يحوِّل محتوى السلسلة النصية التي استدعيت معه إلى نمط السلسلة النصية المثالية في C (السلسلة النصية المنتهية بالمحرف null).
• التابع length()‎: يعيد عدد محارف السلسلة النصية التي استدعيت معه.
• التابع remove()‎: تحذف عددًا محدَّدًا من محارف السلسلة النصية التي استدعيت معها.
• التابع replace()‎: يبدِّل محرفًا أو سلسلةً نصيةً فرعيةً مكان محرف أو سلسلة نصية فرعية محدَّدة موجودة في السلسلة النصية التي استدعيت معه.
• التابع trim()‎: يزيل جميع المسافات البيضاء من بداية ونهاية السلسلة النصية التي استدعيت معه.

مصادر

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