الفرق بين المراجعتين ل"Kotlin/text/isDefined"

من موسوعة حسوب
اذهب إلى التنقل اذهب إلى البحث
(أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: التابع text.isDefined()‎ في لغة Kotlin}}</noinclude> تعيد الدالة <code>isDefined()</code>‎ القيمة <code>true</c...')
 
سطر 1: سطر 1:
 
<noinclude>{{DISPLAYTITLE: التابع text.isDefined()‎ في لغة Kotlin}}</noinclude>
 
<noinclude>{{DISPLAYTITLE: التابع text.isDefined()‎ في لغة Kotlin}}</noinclude>
تعيد الدالة <code>isDefined()</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>isDefined()</code>‎ القيمة <code>true</code> في حال كان كود [[Kotlin/Char/index|الحرف]] (Unicode code point) الذي استٌدعيت عبره مُعرّفًا في اليونيكود (Unicode).
 
== البنية العامة ==
 
== البنية العامة ==
 
<syntaxhighlight lang="kotlin">
 
<syntaxhighlight lang="kotlin">
actual fun String?.equals(
+
inline fun Char.isDefined(): Boolean  
    other: String?,
 
    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>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]].
 
== القيم المعادة ==
 
== القيم المعادة ==
 
قيمة منطقية.
 
قيمة منطقية.
سطر 19: سطر 11:
 
== أمثلة ==
 
== أمثلة ==
  
=== استخدام الدالة <code>isDefined()‎</code> مع السلاسل النصية ===
+
=== استخدام الدالة <code>isDefined()‎</code> مع الحروف ===
تُعرّف الشيفرة الآتية [[Kotlin/String|سلستين نصيتين]] <code>a</code> و <code>b</code> ثم تستدعي الدالة <code>isDefined()‎</code> عبر <code>a</code> لمقارنتها مع <code>b</code>، ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
+
تُعرّف الشيفرة الآتية [[Kotlin/Char/index|حرفًا]] <code>x</code> ثم تستدعي الدالة <code>isDefined()‎</code> عبره، ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
 
fun main(args: Array<String>) {     
 
fun main(args: Array<String>) {     
     val a = "hsoub"
+
     val x = 'a'    
    val b = "hsouB" 
+
     print(x.isDefined()) // true
   
 
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>
 
</syntaxhighlight>
 
== انظر أيضًا ==
 
== انظر أيضًا ==
* <code>[[Kotlin/text/category|category]]</code>: تعيد <code>category</code> قيمة تبيّن الفئة العامة للحرف.
+
* <code>[[Kotlin/text/equals|equals]]()‎</code>: تعيد  القيمة <code>true</code> في حال كان الحرف أو السلسلة النصية التي استُدعيت عبرها مساوية للحرف أو السلسلة النصية المُمرّرة إليها. في حال تمرير الوسيط <code>ignoreCase</code> وإعطائه القيمة <code>true</code> فإنّ الدالة لن تفرق بين الحروف الصغيرة والكبيرة. القيمة الابتدائية للوسيط <code>ignoreCase</code> هي<code>false</code>.
  
 
== مصادر ==
 
== مصادر ==
* [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/equals.html صفحة الدالة isDefined()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+
* [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/is-defined.html صفحة الدالة isDefined()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 
[[تصنيف:Kotlin]]
 
[[تصنيف:Kotlin]]
 
[[تصنيف:Kotlin Method]]
 
[[تصنيف:Kotlin Method]]

مراجعة 18:21، 1 يوليو 2018

تعيد الدالة isDefined()‎ القيمة true في حال كان كود الحرف (Unicode code point) الذي استٌدعيت عبره مُعرّفًا في اليونيكود (Unicode).

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

inline fun Char.isDefined(): Boolean

يُلاحَظ وجود الكلمة المفتاحية inline للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع توثيق الدوال المباشرة (inline functions).

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

قيمة منطقية.

أمثلة

استخدام الدالة isDefined()‎ مع الحروف

تُعرّف الشيفرة الآتية حرفًا x ثم تستدعي الدالة isDefined()‎ عبره، ثم تطبع الناتج:

fun main(args: Array<String>) {    
    val x = 'a'    
    print(x.isDefined()) // true
}

انظر أيضًا

  • equals()‎: تعيد القيمة true في حال كان الحرف أو السلسلة النصية التي استُدعيت عبرها مساوية للحرف أو السلسلة النصية المُمرّرة إليها. في حال تمرير الوسيط ignoreCase وإعطائه القيمة true فإنّ الدالة لن تفرق بين الحروف الصغيرة والكبيرة. القيمة الابتدائية للوسيط ignoreCase هيfalse.

مصادر