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

من موسوعة حسوب
لا ملخص تعديل
مراجعة وتدقيق.
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE: التابع text.isDefined()‎ في لغة Kotlin}}</noinclude>
<noinclude>{{DISPLAYTITLE: الدالة text.isDefined()‎ في Kotlin}}</noinclude>
تعيد الدالة <code>isDefined()</code>‎ القيمة <code>true</code> في حال كان [[Kotlin/Char/index|الحرف]] (Unicode code point) الذي استٌدعيت عبره مُعرّفًا في اليونيكود (Unicode).
تتحقق الدالة <code>isDefined()</code>‎ إن كان [[Kotlin/Char|المحرف]] (Unicode code point) الذي استٌدعيت معها مُعرّفًا في الترميز الموحَّد (Unicode) أم لا.
== البنية العامة ==
== البنية العامة ==
<syntaxhighlight lang="kotlin">
المنصة المطلوبة: '''JVM'''.<syntaxhighlight lang="kotlin">
inline fun Char.isDefined(): Boolean  
inline fun Char.isDefined(): Boolean  


</syntaxhighlight>يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]].
</syntaxhighlight>وجود الكلمة المفتاحية <code>inline</code> يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، ارجع إلى صفحة <nowiki/>[[Kotlin/inline functions|الدوال المباشرة (inline functions)]]).
== القيم المعادة ==
== القيم المعادة ==
قيمة منطقية.
تعاد القيمة <code>true</code> إن كان [[Kotlin/Char|المحرف]] (Unicode code point) المعطى مُعرّفًا في الترميز الموحَّد (Unicode)، أو القيمة <code>false</code> خلاف ذلك.


== أمثلة ==
== أمثلة ==
 
استعمال الدالة <code>isDefined()‎</code> لمعرفة إن كان المحرف 'أ' العربي معرَّفًا في الترميز الموحد أم لا:<syntaxhighlight lang="kotlin">
=== استخدام الدالة <code>isDefined()‎</code> مع الحروف ===
تُعرّف الشيفرة الآتية [[Kotlin/Char/index|حرفًا]] <code>x</code> ثم تستدعي الدالة <code>isDefined()‎</code> عبره، ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
fun main(args: Array<String>) {     
fun main(args: Array<String>) {     
     val x = 'a'     
     val x = 'أ'     
     print(x.isDefined()) // true
     print(x.isDefined()) // true
}
}
</syntaxhighlight>
</syntaxhighlight>
== انظر أيضًا ==
== انظر أيضًا ==
* <code>[[Kotlin/text/equals|equals]]()</code>: تعيد  القيمة <code>true</code> في حال كان الحرف أو السلسلة النصية التي استُدعيت عبرها مساوية للحرف أو السلسلة النصية المُمرّرة إليها. في حال تمرير الوسيط <code>ignoreCase</code> وإعطائه القيمة <code>true</code> فإنّ الدالة لن تفرق بين الحروف الصغيرة والكبيرة. القيمة الابتدائية للوسيط <code>ignoreCase</code> هي<code>false</code>.
*الدالة [[Kotlin/text/equals|<code>equals()</code>‎]]: تتحقق من تساوي محرفين أو سلسلتين نصيتين مع بعضهما بعضًا.
 
*الدالة [[Kotlin/text/isDigit|<code>isDigit()</code>‎]]: تتحقق إن كان [[Kotlin/Char|المحرف]] الذي استٌدعيت معه رقمًا أم لا.
*الدالة [[Kotlin/text/isHighSurrogate|<code>isHighSurrogate()</code>‎]]: تتحقق إن كان [[Kotlin/Char|المحرف]] الذي استٌدعي معها بديلًا علويًا لعدد بتات الترميز الموحد (Unicode high-surrogate code unit).
*الدالة [[Kotlin/text/isISOControl|<code>isISOControl()</code>‎]]: تتحقق إن كان [[Kotlin/Char|المحرف]] الذي استٌدعي معها هو أحد محارف تحكمISO ‎‎‏ ‎ISO control character)‎‎‎).
*الدالة [[Kotlin/text/isIdentifierIgnorable|<code>isIdentifierIgnorable()</code>‎]]: تتحقق إن كان [[Kotlin/Char|المحرف]] الذي استٌدعي معها محرفًا قابلًا للإهمال (ignorable character) في مُعرِّفات جافا (Java identifier) أو معرِّفات الترميز الموحَّد (Unicode identifier).
*الدالة [[Kotlin/text/isJavaIdentifierPart|<code>isJavaIdentifierPart()</code>‎]]: تتحقق إن كان من المحتمل أن يكون [[Kotlin/Char|المحرف]] الذي استٌدعي معها جزءًا من مُعرِّف جافا (Java identifier) وليس المحرف الأول من المُعرّف.
*الدالة [[Kotlin/text/isJavaIdentifierStart|<code>isJavaIdentifierStart()</code>‎]]: تتحقق إن كان يسمح أن يكون [[Kotlin/Char|المحرف]] الذي استٌدعي معها المحرف الأول من مُعرِّف جافا (Java identifier).
== مصادر ==
== مصادر ==
* [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/is-defined.html صفحة الدالة isDefined()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
* [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/is-defined.html صفحة الدالة isDefined()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin Method]]
[[تصنيف:Kotlin Method]]

مراجعة 05:31، 13 أغسطس 2018

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

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

المنصة المطلوبة: JVM.

inline fun Char.isDefined(): Boolean

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

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

تعاد القيمة true إن كان المحرف (Unicode code point) المعطى مُعرّفًا في الترميز الموحَّد (Unicode)، أو القيمة false خلاف ذلك.

أمثلة

استعمال الدالة isDefined()‎ لمعرفة إن كان المحرف 'أ' العربي معرَّفًا في الترميز الموحد أم لا:

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

انظر أيضًا

  • الدالة equals(): تتحقق من تساوي محرفين أو سلسلتين نصيتين مع بعضهما بعضًا.
  • الدالة isDigit(): تتحقق إن كان المحرف الذي استٌدعيت معه رقمًا أم لا.
  • الدالة isHighSurrogate(): تتحقق إن كان المحرف الذي استٌدعي معها بديلًا علويًا لعدد بتات الترميز الموحد (Unicode high-surrogate code unit).
  • الدالة isISOControl(): تتحقق إن كان المحرف الذي استٌدعي معها هو أحد محارف تحكمISO ‎‎‏ ‎ISO control character)‎‎‎).
  • الدالة isIdentifierIgnorable(): تتحقق إن كان المحرف الذي استٌدعي معها محرفًا قابلًا للإهمال (ignorable character) في مُعرِّفات جافا (Java identifier) أو معرِّفات الترميز الموحَّد (Unicode identifier).
  • الدالة isJavaIdentifierPart(): تتحقق إن كان من المحتمل أن يكون المحرف الذي استٌدعي معها جزءًا من مُعرِّف جافا (Java identifier) وليس المحرف الأول من المُعرّف.
  • الدالة isJavaIdentifierStart(): تتحقق إن كان يسمح أن يكون المحرف الذي استٌدعي معها المحرف الأول من مُعرِّف جافا (Java identifier).

مصادر