الفرق بين المراجعتين لصفحة: «Kotlin/kotlin.text/equals»

المراجعة الحالية بتاريخ 05:15، 3 سبتمبر 2018

تتحقق الدالة equals()‎ من تساوي السلسلة النصية أو المحرف الذي استُدعي معها مع السلسلة النصية أو المحرف المُمرّر إليها مع إمكانية تجاهل حالة المحارف.

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

actual fun String?.equals(
    other: String?, 
    ignoreCase: Boolean = false
): Boolean

fun Char.equals(
    other: Char, 
    ignoreCase: Boolean = false
): Boolean

المعاملات

`other`

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

`ignoreCase`

قيمة منطقية تحدد إن كان يراد تجاهل حالة الحروف أم لا أثناء الموازنة. القيمة الافتراضية هي: false أي أخذ حالة الحروف بالحسبان.

يعد محرفان متماثلين تمامًا بغض النظر عن حالة كل منها (محرف كبير أو صغير) إن كان أحد الخيارات التالية -على الأقل- محققًا:

المحرفان هما نفس المحرف؛ أي أُعيدَت القيمة true عند الموازنة بينهما باستعمال المعامل ==.
طبقت الدالة toUpperCase على كلا المحرفين قبل إجراء عملية الموازنة بينهما مثل الحالة السابقة (أي أعطت عملية الموازنة بينهما بعد ذلك القيمة true).
طبقت الدالة toLowerCase على كلا المحرفين قبل إجراء عملية الموازنة بينهما (أي أعطت عملية الموازنة بينهما بعد ذلك القيمة true).

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

تعاد القيمة true إن كانت السلسلة النصية أو المحرف other مساويةً للسلسلة النصية أو أو مساويًا للمحرف المعطى، أو تعاد القيمة false خلاف ذلك.

أمثلة

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

fun main(args: Array<String>) {
    val a = "hsoub"
    val b = "hsouB"

    print(a.equals(b)) // false
    print(a.equals(b, true)) // true

}

انظر أيضًا

الدالة compareTo()‎: توازن بين سلسلتين نصيتين معجميًّا (lexicographically)، مع إمكانية تجاهل حالة الأحرف.
الدالة contentEquals()‎: تتحقق من تساوي محتوى السلسلة النصية التي استُدعيت معها مع محتوى سلسلة المحارف أو الكائن StringBuffer المُمرّر إليها.
الدالة contains()‎ إن كانت سلسلة المحارف التي استُدعيت معها تحوي المحرف أو سلسلة المحارف المُمرّرة إليها.

مصادر

صفحة الدالة equals()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.

@@ سطر 1: / سطر 1: @@
-<noinclude>{{DISPLAYTITLE: التابع text.equals()‎ في لغة Kotlin}}</noinclude>
+<noinclude>{{DISPLAYTITLE: الدالة <code>equals()</code>‎ في Kotlin}}</noinclude>
-تعيد الدالة <code>equals()</code>‎ القيمة <code>true</code> في حال كان [[Kotlin/Char/index|الحرف]] أو [[Kotlin/String|السلسلة النصية]] التي استُدعيت عبرها مساوية [[Kotlin/Char/index|للحرف]] أو [[Kotlin/String|السلسلة النصية]] المُمرّرة إليها. في حال تمرير الوسيط <code>ignoreCase</code> وإعطائه القيمة <code>true</code> فإنّ الدالة لن تفرق بين الحروف الصغيرة والكبيرة. القيمة الابتدائية للوسيط <code>ignoreCase</code>  هي <code>false</code>.
+تتحقق الدالة <code>equals()</code>‎ من تساوي [[Kotlin/String|السلسلة النصية]] أو [[Kotlin/Char|المحرف]] الذي استُدعي معها مع [[Kotlin/String|السلسلة النصية]] أو [[Kotlin/Char|المحرف]] المُمرّر إليها مع إمكانية تجاهل حالة المحارف.
 == البنية العامة ==
 <syntaxhighlight lang="kotlin">
@@ سطر 7: / سطر 7: @@
      ignoreCase: Boolean = false
 ): Boolean
-</syntaxhighlight>تعيد الدالة <code>equals()</code>‎ القيمة <code>true</code> في حال كانت [[Kotlin/String|السلسلة النصية]] التي استُدعيت عبرها مساوية [[Kotlin/String|للسلسلة النصية]] المُمرّرة إليها. في حال تمرير الوسيط <code>ignoreCase</code> وإعطائه القيمة <code>true</code> فإنّ الدالة لن تفرق بين الحروف الصغيرة والكبيرة. القيمة الابتدائية للوسيط <code>ignoreCase</code>  هي <code>false</code>.<syntaxhighlight lang="kotlin">
 fun Char.equals(
      other: Char,
      ignoreCase: Boolean = false
 ): Boolean
-</syntaxhighlight>تعيد الدالة <code>equals()</code>‎ القيمة <code>true</code> في حال كان [[Kotlin/Char/index|الحرف]]  الذي استُدعيت عبره مساويًا [[Kotlin/Char/index|للحرف]] المُمرّر إليها. في حال تمرير الوسيط <code>ignoreCase</code> وإعطائه القيمة <code>true</code> فإنّ الدالة لن تفرق بين الحروف الصغيرة والكبيرة. القيمة الابتدائية للوسيط <code>ignoreCase</code>  هي <code>false</code>.
+</syntaxhighlight>
+== المعاملات ==
+=== <code>other</code> ===
+[[Kotlin/String|سلسلة نصية]] أو [[Kotlin/Char|محرف]] يراد التحقق من تساويها مع السلسلة النصية أو تساويه مع المحرف المعطى.
+=== <code>ignoreCase</code> ===
+قيمة منطقية تحدد إن كان يراد تجاهل حالة الحروف أم لا أثناء الموازنة. القيمة الافتراضية هي: <code>false</code> أي أخذ حالة الحروف بالحسبان.
+يعد محرفان متماثلين تمامًا بغض النظر عن حالة كل منها (محرف كبير أو صغير) إن كان أحد الخيارات التالية -على الأقل- محققًا:
+* المحرفان هما نفس المحرف؛ أي أُعيدَت القيمة <code>true</code> عند الموازنة بينهما باستعمال المعامل <code>==</code>.
+* طبقت الدالة <code>[[Kotlin/kotlin.text/toUpperCase|toUpperCase]]</code> على كلا المحرفين قبل إجراء عملية الموازنة بينهما مثل الحالة السابقة (أي أعطت عملية الموازنة بينهما بعد ذلك القيمة <code>true</code>).
+* طبقت الدالة <code>[[Kotlin/text/toLowerCase|toLowerCase]]</code> على كلا المحرفين قبل إجراء عملية الموازنة بينهما (أي أعطت عملية الموازنة بينهما بعد ذلك القيمة <code>true</code>).
 == القيم المعادة ==
-قيمة منطقية.
+تعاد القيمة <code>true</code> إن كانت السلسلة النصية أو المحرف <code>other</code> مساويةً للسلسلة النصية أو أو مساويًا للمحرف المعطى، أو تعاد القيمة <code>false</code> خلاف ذلك.
 == أمثلة ==
+مثالٌ على استعمال الدالة <code>equals()‎</code>:<syntaxhighlight lang="kotlin">
+fun main(args: Array<String>) {
+    val a = "hsoub"
+    val b = "hsouB"
+    print(a.equals(b)) // false
+    print(a.equals(b, true)) // true
-=== استخدام الدالة <code>equals()‎</code> مع السلاسل النصية ===
-تُعرّف الشيفرة الآتية [[Kotlin/String|سلستين نصيتين]] <code>a</code> و <code>b</code> ثم تستدعي الدالة <code>equals()‎</code> عبر <code>a</code> لمقارنتها مع <code>b</code>، ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
-fun main(args: Array<String>) {
-    val a = "hsoub"
-    val b = "hsouB"
-	print(a.equals(b)) // false
-}
-</syntaxhighlight>
-=== استخدام الدالة <code>equals()‎</code> مع السلاسل النصية مع تمرير الوسيط <code>ignoreCase</code>   ===
-تُعرّف الشيفرة الآتية [[Kotlin/String|سلستين نصيتين]] <code>a</code> و <code>b</code> ثم تستدعي الدالة <code>equals()‎</code> عبر <code>a</code> لمقارنتها مع <code>b</code>،مع تمرير القيمة <code>true</code>، ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
-fun main(args: Array<String>) {
-    val a = "hsoub"
-    val b = "hsouB"
-	print(a.equals(b, true)) // true
 }
 </syntaxhighlight>
 == انظر أيضًا ==
-* <code>[[Kotlin/text/category|category]]</code>: تعيد <code>category</code> قيمة تبيّن الفئة العامة للحرف.
+* الدالة <code>[[Kotlin/kotlin.text/compareTo|compareTo()‎]]</code>: توازن بين سلسلتين نصيتين معجميًّا (lexicographically)، مع إمكانية تجاهل حالة الأحرف.
+* الدالة <code>[[Kotlin/kotlin.text/contentEquals|contentEquals()‎]]</code>: تتحقق من تساوي محتوى السلسلة النصية التي استُدعيت معها مع محتوى <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] أو الكائن <code>StringBuffer</code> المُمرّر إليها.
+* الدالة <code>[[Kotlin/kotlin.text/contains|contains()‎]]</code> إن كانت <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] التي استُدعيت معها تحوي <nowiki/>[[Kotlin/Char|المحرف]] أو <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] المُمرّرة إليها.
 == مصادر ==
-* [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/equals.html صفحة الدالة equals()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+* [http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/equals.html صفحة الدالة equals()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
-[[تصنيف:Kotlin Method]]
+[[تصنيف:Kotlin Function]]
+[[تصنيف:Kotlin Text]]