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