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

@@ سطر 1: / سطر 1: @@
-توازن الدالة <code>compareTo()‎</code> بين سلسلتين نصيتين وتحدِّد أيهما أكبر من الأخرى أو إن كانتا متساويتين. تجري الدالة عملية الموازنة على كل محرفين متقابلين من السلسلتين النصيتين المراد الموازنة بينهما بناءً على قيمة هذين المحرفين في الجدول [[Arduino/asciichart|ASCII]]. هذا يعني أنَّ الحرف 'a' مثلًا أصغر من المحرف 'b' (يأتي قبله) ولكنه أكبر من المحرف 'A' (يأتي بعده)؛ الأرقام أصغر من الحروف الأبجدية دومًا.
+<noinclude>{{DISPLAYTITLE:التابع <code>String.compareTo()‎</code> في أردوينو}}</noinclude>
+يوازن التابع <code>compareTo()‎</code> بين سلسلتين نصيتين ويحدِّد أيهما أكبر من الأخرى أو إن كانتا متساويتين. يجري التابع عملية الموازنة على كل محرفين متقابلين من السلسلتين النصيتين المراد الموازنة بينهما بناءً على قيمة هذين المحرفين في الجدول [[Arduino/asciichart|ASCII]]. هذا يعني أنَّ الحرف 'a' مثلًا أصغر من المحرف 'b' (يأتي قبله) ولكنَّه أكبر من المحرف 'A' (يأتي بعده)؛ الأرقام أصغر من الحروف الأبجدية دومًا.
-== البنية العامة ==
+==البنية العامة==
 <syntaxhighlight lang="arduino">
 string.compareTo(string2)
 </syntaxhighlight>
+==المعاملات==
+==='''<code>string</code>'''===
+[[Arduino/stringobject|السلسلة النصية]] الأولى المراد موازنتها.
+===<code>string2</code>===
+[[Arduino/stringobject|السلسلة النصية]] الثانية المراد موازنتها مع المعامل <code>string</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
-=== '''<code>string</code>''' ===
+  Serial.println(stringValue.compareTo("xyz"));  // -1
-السلسلة النصية الأولى المراد موازنتها.
+}
+</syntaxhighlight>
-=== <code>string2</code> ===
+==انظر أيضًا==
-السلسلة النصية الثانية المراد موازنتها مع السلسلة النصية <code>string</code>.
+*التابع <code>[[Arduino/stringobject/equals|equals()‎]]</code>: يتحقَّق إن كانت السلسلة النصية التي استدعيت معه مساويةً للسلسلة النصية التي مُرِّرت إليه.
+*التابع <code>[[Arduino/stringobject/indexof|indexOf()‎]]</code>: يعيد فهرس أول ظهور لمحرف أو سلسلة نصية معيَّنة ضمن السلسلة النصية التي استدعيت معه.
-== القيم المعادة ==
+*التابع <code>[[Arduino/stringobject/length|length()‎]]</code>: يعيد عدد محارف السلسلة النصية التي استدعيت معه.
-يعاد عدد سالب إن كانت السلسلة النصية <code>string</code> الأولى أصغر من السلسلة النصية <code>string2</code> الثانية، أو يعاد العدد 0 إن كانت السلسلة <code>string</code> مساويةً للسلسلة <code>string2</code>، أو يعاد عددٌ موجبٌ إن كانت السلسلة <code>string2</code> الأولى أكبر من السلسلة <code>string2</code> الثانية.
+*التابع <code>[[Arduino/stringobject/replace|replace()‎]]</code>: يبدِّل [[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|السلسلة النصية]] التي استدعيت معه.
-* [https://www.arduino.cc/reference/en/language/variables/data-types/string/functions/compareto/ صفحة الدالة compareTo()‎ في توثيق أردوينو الرسمي.]
+==مصادر==
+*[https://www.arduino.cc/reference/en/language/variables/data-types/string/functions/compareto/ صفحة التابع compareTo()‎ في توثيق أردوينو الرسمي.]
+[[تصنيف: Arduino]]
+[[تصنيف: Arduino Method]]
+[[تصنيف: Arduino String]]