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

مراجعة 09:07، 30 أكتوبر 2018

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

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

string.compareTo(string2)

المعاملات

`string`

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

`string2`

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

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

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

انظر أيضًا

التابع 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>string2</code> الأولى أكبر من السلسلة <code>string2</code> الثانية.
+==انظر أيضًا==
+* التابع <code>[[Arduino/stringobject/equals|equals()‎]]</code>: يتحقَّق إن كانت السلسلة النصية التي استدعيت معه مساويةً للسلسلة النصية التي مُرِّرت إليه.
+* التابع <code>[[Arduino/stringobject/indexof|indexOf()‎]]</code>: يعيد فهرس أول ظهور لمحرف أو سلسلة نصية معيَّنة ضمن السلسلة النصية التي استدعيت معه.
+* التابع <code>[[Arduino/stringobject/length|length()‎]]</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>string</code>''' ===
-السلسلة النصية الأولى المراد موازنتها.
-=== <code>string2</code> ===
-السلسلة النصية الثانية المراد موازنتها مع السلسلة النصية <code>string</code>.
-== القيم المعادة ==
-يعاد عدد سالب إن كانت السلسلة النصية <code>string</code> الأولى أصغر من السلسلة النصية <code>string2</code> الثانية، أو يعاد العدد 0 إن كانت السلسلة <code>string</code> مساويةً للسلسلة <code>string2</code>، أو يعاد عددٌ موجبٌ إن كانت السلسلة <code>string2</code> الأولى أكبر من السلسلة <code>string2</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]]