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

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

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

@@ سطر 12: / سطر 12: @@
 [[Arduino/stringobject|السلسلة النصية]] الثانية المراد موازنتها مع المعامل <code>string</code>.
 ==القيم المعادة==
-يعاد عدد سالب إن كانت السلسلة النصية <code>string</code> الأولى أصغر من السلسلة النصية <code>string2</code> الثانية، أو يعاد العدد 0 إن كانت السلسلة <code>string</code> مساويةً للسلسلة <code>string2</code>، أو يعاد عددٌ موجبٌ إن كانت السلسلة <code>string2</code> الأولى أكبر من السلسلة <code>string2</code> الثانية.
+يعاد عدد سالب إن كانت السلسلة النصية <code>string</code> الأولى أصغر من السلسلة النصية <code>string2</code> الثانية، أو يعاد العدد 0 إن كانت السلسلة <code>string</code> مساويةً للسلسلة <code>string2</code>، أو يعاد عددٌ موجبٌ إن كانت السلسلة <code>string</code> الأولى أكبر من السلسلة <code>string2</code> الثانية.
+==أمثلة==
+مثال على استعمال الدالة <code>compareTo()‎</code>:<syntaxhighlight lang="arduino">
+String stringValue = "wiki Hsoub";
+void setup() {
+   Serial.begin(9600);
+}
+void loop() {
+  Serial.println(stringValue.compareTo("Wiki")); // 32
+  Serial.println(stringValue.compareTo("xyz"));  // -1
+}
+</syntaxhighlight>
 ==انظر أيضًا==
-* التابع <code>[[Arduino/stringobject/equals|equals()‎]]</code>: يتحقَّق إن كانت السلسلة النصية التي استدعيت معه مساويةً للسلسلة النصية التي مُرِّرت إليه.
+*التابع <code>[[Arduino/stringobject/equals|equals()‎]]</code>: يتحقَّق إن كانت السلسلة النصية التي استدعيت معه مساويةً للسلسلة النصية التي مُرِّرت إليه.
-* التابع <code>[[Arduino/stringobject/indexof|indexOf()‎]]</code>: يعيد فهرس أول ظهور لمحرف أو سلسلة نصية معيَّنة ضمن السلسلة النصية التي استدعيت معه.
+*التابع <code>[[Arduino/stringobject/indexof|indexOf()‎]]</code>: يعيد فهرس أول ظهور لمحرف أو سلسلة نصية معيَّنة ضمن السلسلة النصية التي استدعيت معه.
-* التابع <code>[[Arduino/stringobject/length|length()‎]]</code>: يعيد عدد محارف السلسلة النصية التي استدعيت معه.
+*التابع <code>[[Arduino/stringobject/length|length()‎]]</code>: يعيد عدد محارف السلسلة النصية التي استدعيت معه.
-* التابع <code>[[Arduino/stringobject/replace|replace()‎]]</code>: يبدِّل [[Arduino/char|محرفًا]] أو سلسلةً نصيةً فرعيةً مكان محرف أو سلسلة نصية فرعية محدَّدة موجودة في السلسلة النصية التي استدعيت معه.
+*التابع <code>[[Arduino/stringobject/replace|replace()‎]]</code>: يبدِّل [[Arduino/char|محرفًا]] أو سلسلةً نصيةً فرعيةً مكان محرف أو سلسلة نصية فرعية محدَّدة موجودة في السلسلة النصية التي استدعيت معه.
-* التابع <code>[[Arduino/stringobject/setcharat|setCharAt()‎]]</code>: يعيِّن قيمة [[Arduino/char|محرفٍ]] متوضِّع في [[Arduino/stringobject|السلسلة النصية]] التي استدعيت معه إلى [[Arduino/char|المحرف]] المُمرَّر إليه.
+*التابع <code>[[Arduino/stringobject/setcharat|setCharAt()‎]]</code>: يعيِّن قيمة [[Arduino/char|محرفٍ]] متوضِّع في [[Arduino/stringobject|السلسلة النصية]] التي استدعيت معه إلى [[Arduino/char|المحرف]] المُمرَّر إليه.
-* التابع <code>[[Arduino/stringobject/startswith|startsWith()‎]]</code>: تتحقَّق إن كانت السلسلة النصية التي استدعيت معه تبدأ بالمحارف نفسها التي مُرِّرت إليه.
-* التابع <code>[[Arduino/stringobject/substring|substring()‎]]</code>: يجلب جزءًا محدَّدًا من [[Arduino/stringobject|السلسلة النصية]] التي استدعيت معه.
+*التابع <code>[[Arduino/stringobject/startswith|startsWith()‎]]</code>: تتحقَّق إن كانت السلسلة النصية التي استدعيت معه تبدأ بالمحارف نفسها التي مُرِّرت إليه.
+*التابع <code>[[Arduino/stringobject/substring|substring()‎]]</code>: يجلب جزءًا محدَّدًا من [[Arduino/stringobject|السلسلة النصية]] التي استدعيت معه.
 ==مصادر==
 *[https://www.arduino.cc/reference/en/language/variables/data-types/string/functions/compareto/ صفحة التابع compareTo()‎ في توثيق أردوينو الرسمي.]