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

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

يتحقَّق التابع equals()‎ إن كانت السلسلة النصية التي استدعيت معه مساويةً للسلسلة النصية التي مُرِّرت إليه. عملية التحقق من التساوي حساسة لحالة الأحرف؛ هذا يعني أنَّ السلسلة "hello" لا تساوي "Hello" على الإطلاق.

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

string.equals(string2)

المعاملات

`string`

السلسلة النصية الأولى المراد التحقق من تساويها مع السلسلة string2.

`string2`

السلسلة النصية الثانية المراد التحقُّق من تساويها مع السلسلة string.

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

تعاد القيمة true المنطقية إن كانت السلسلة string مساويةً للسلسلة string2، أو تعاد القيمة false خلاف ذلك.

أمثلة

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

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

void loop() {
  Serial.println(stringValue.equals("wiki Hsoub")); // 1 or true
  Serial.println(stringValue.equals("Wiki hsoub")); // 0 or false
}

انظر أيضًا

التابع compareTo()‎: يوازن بين سلسلتين نصيتين ويحدِّد أيهما أكبر من الأخرى أو إن كانتا متساويتين.
التابع endsWith()‎: يتحقَّق إن كانت السلسلة النصية التي استدعيت معه تنتهي بالمحارف نفسها التي مُرِّرت إليه.
التابع equalsIgnoreCase()‎: تتحقَّق إن كانت السلسلة النصية التي استدعيت معه مساويةً للسلسلة النصية التي مُرِّرت إليه مع عدم أخذ حالة الأحرف بالحسبان.
التابع indexOf()‎: يعيد فهرس أول ظهور لمحرف أو سلسلة نصية معيَّنة ضمن السلسلة النصية التي استدعيت معه.
التابع length()‎: يعيد عدد محارف السلسلة النصية التي استدعيت معه.

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

مصادر

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

@@ سطر 1: / سطر 1: @@
-تتحقَّق الدالة <code>equals()‎</code> إن كانت السلسلة النصية التي استدعيت معها مساويةً للسلسلة النصية التي مُرِّرت إليها. عملية التحقق من التساوي حساسة لحالة الأحرف؛ هذا يعني أنَّ السلسلة "hello" لا تساوي "Hello" على الإطلاق.
+<noinclude>{{DISPLAYTITLE:التابع <code>String.equals()‎</code> في أردوينو}}</noinclude>
+يتحقَّق التابع <code>equals()‎</code> إن كانت السلسلة النصية التي استدعيت معه مساويةً للسلسلة النصية التي مُرِّرت إليه. عملية التحقق من التساوي حساسة لحالة الأحرف؛ هذا يعني أنَّ السلسلة "hello" لا تساوي "Hello" على الإطلاق.
-== البنية العامة ==
+==البنية العامة==
 <syntaxhighlight lang="arduino">
 string.equals(string2)
 </syntaxhighlight>
+==المعاملات==
-== المعاملات ==
+===<code>string</code>===
+[[Arduino/stringobject|السلسلة النصية]] الأولى المراد التحقق من تساويها مع السلسلة <code>string2</code>.
-=== <code>string</code> ===
+===<code>string2</code>===
-[[Arduino/stringobject|السلسلة النصية]] الأولى المراد التحقق من تساويها مع السلسلة النصية <code>string2</code>.
-=== <code>string2</code> ===
 [[Arduino/stringobject|السلسلة النصية]] الثانية المراد التحقُّق من تساويها مع السلسلة <code>string</code>.
+==القيم المعادة==
+تعاد القيمة <code>[[Arduino/constants#.D8.A7.D9.84.D8.AB.D8.A7.D8.A8.D8.AA true|true]]</code> المنطقية إن كانت السلسلة <code>string</code> مساويةً للسلسلة <code>string2</code>، أو تعاد القيمة <code>[[Arduino/constants#.D8.A7.D9.84.D8.AB.D8.A7.D8.A8.D8.AA false|false]]</code> خلاف ذلك.
+==أمثلة==
+مثال على استعمال الدالة <code>equals()‎</code>:<syntaxhighlight lang="arduino">
+String stringValue = "wiki Hsoub";
+void setup() {
+   Serial.begin(9600);
+}
-== القيم المعادة ==
+void loop() {
-تعاد القيمة <code>[[Arduino/constants#.D8.A7.D9.84.D8.AB.D8.A7.D8.A8.D8.AA true|true]]</code> المنطقية إن كانت السلسلة النصية <code>string</code> مساويةً للسلسلة <code>string2</code>، أو تعاد القيمة <code>[[Arduino/constants#.D8.A7.D9.84.D8.AB.D8.A7.D8.A8.D8.AA false|false]]</code> خلاف ذلك.
+  Serial.println(stringValue.equals("wiki Hsoub")); // 1 or true
+  Serial.println(stringValue.equals("Wiki hsoub")); // 0 or false
-== انظر أيضًا ==
+}
+</syntaxhighlight>
+==انظر أيضًا==
+*التابع <code>[[Arduino/stringobject/compareto|compareTo()‎]]</code>: يوازن بين سلسلتين نصيتين ويحدِّد أيهما أكبر من الأخرى أو إن كانتا متساويتين.
+*التابع <code>[[Arduino/stringobject/endswith|endsWith()‎]]</code>: يتحقَّق إن كانت السلسلة النصية التي استدعيت معه تنتهي بالمحارف نفسها التي مُرِّرت إليه.
+*التابع <code>[[Arduino/stringobject/equalsignorecase|equalsIgnoreCase()‎]]</code>: تتحقَّق إن كانت السلسلة النصية التي استدعيت معه مساويةً للسلسلة النصية التي مُرِّرت إليه مع عدم أخذ حالة الأحرف بالحسبان.
+*التابع <code>[[Arduino/stringobject/indexof|indexOf()‎]]</code>: يعيد فهرس أول ظهور لمحرف أو سلسلة نصية معيَّنة ضمن السلسلة النصية التي استدعيت معه.
+*التابع <code>[[Arduino/stringobject/length|length()‎]]</code>: يعيد عدد محارف السلسلة النصية التي استدعيت معه.
-== مصادر ==
+*التابع <code>[[Arduino/stringobject/startswith|startsWith()‎]]</code>: تتحقَّق إن كانت السلسلة النصية التي استدعيت معه تبدأ بالمحارف نفسها التي مُرِّرت إليه.
-* [https://www.arduino.cc/reference/en/language/variables/data-types/string/functions/equals/ صفحة الدالة equals()‎ في توثيق أردوينو الرسمي.]
+*التابع <code>[[Arduino/stringobject/trim|trim()‎]]</code>: يزيل جميع المسافات البيضاء من بداية ونهاية السلسلة النصية التي استدعيت معه.
+==مصادر==
+*[https://www.arduino.cc/reference/en/language/variables/data-types/string/functions/equals/ صفحة التابع equals()‎ في توثيق أردوينو الرسمي.]
+[[تصنيف: Arduino]]
+[[تصنيف: Arduino Method]]
+[[تصنيف: Arduino String]]