التابع String.compareTo()‎ في أردوينو

يوازن التابع compareTo()‎ بين سلسلتين نصيتين ويحدِّد أيهما أكبر من الأخرى أو إن كانتا متساويتين. يجري التابع عملية الموازنة على كل محرفين متقابلين من السلسلتين النصيتين المراد الموازنة بينهما بناءً على قيمة هذين المحرفين في الجدول ASCII. هذا يعني أنَّ الحرف 'a' مثلًا أصغر من المحرف 'b' (يأتي قبله) ولكنَّه أكبر من المحرف 'A' (يأتي بعده)؛ الأرقام أصغر من الحروف الأبجدية دومًا.

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

string.compareTo(string2)

المعاملات

string

السلسلة النصية الأولى المراد موازنتها.

string2

السلسلة النصية الثانية المراد موازنتها مع المعامل string.

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

يعاد عدد سالب إن كانت السلسلة النصية string الأولى أصغر من السلسلة النصية string2 الثانية، أو يعاد العدد 0 إن كانت السلسلة string مساويةً للسلسلة string2، أو يعاد عددٌ موجبٌ إن كانت السلسلة string الأولى أكبر من السلسلة string2 الثانية.

أمثلة

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

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

void loop() {
  Serial.println(stringValue.compareTo("Wiki")); // 32
  Serial.println(stringValue.compareTo("xyz"));  // -1
}

انظر أيضًا

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

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

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

مصادر

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