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

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

تتحقق الدالة isIdentifierIgnorable()‎ إن كان المحرف الذي استٌدعي معها محرفًا قابلًا للإهمال (ignorable character) في مُعرِّفات جافا (Java identifier) أو معرِّفات الترميز الموحَّد (Unicode identifier).

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

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

inline fun Char.isIdentifierIgnorable(): Boolean

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

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

تعاد القيمة true إن كان المحرف المعطى محرفًا قابلًا للإهمال (ignorable character) في مُعرِّفات جافا (Java identifier) أو معرِّفات الترميز الموحَّد (Unicode identifier)، أو تعاد القيمة false خلاف ذلك.

أمثلة

استعمال الدالة isIdentifierIgnorable()‎ لمعرفة أي المحرفين التاليين هو محرف قابل للإهمال في محرفات جافا أو معرفات الترميز الموحد:

fun main(args: Array<String>) {    
    val x = 'a' 
    val y = '\u0000' // null character
    
	print(x.isIdentifierIgnorable()) // false
    print(y.isIdentifierIgnorable()) // true
}

انظر أيضًا

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

مصادر

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

@@ سطر 1: / سطر 1: @@
-<noinclude>{{DISPLAYTITLE: التابع text.isIdentifierIgnorable()‎ في لغة Kotlin}}</noinclude>
+<noinclude>{{DISPLAYTITLE: الدالة text.isIdentifierIgnorable()‎ في Kotlin}}</noinclude>
-تعيد الدالة <code>isIdentifierIgnorable()</code>‎ القيمة <code>true</code> في حال كان [[Kotlin/Char/index|الحرف]] الذي استٌدعيت عبره يجب أن يُهمل في مُعرِّفات جافا (Java identifier) أو اليونيكود.
+تتحقق الدالة <code>isIdentifierIgnorable()</code>‎ إن كان [[Kotlin/Char|المحرف]] الذي استٌدعي معها محرفًا قابلًا للإهمال (ignorable character) في مُعرِّفات جافا (Java identifier) أو معرِّفات الترميز الموحَّد (Unicode identifier).
 == البنية العامة ==
-<syntaxhighlight lang="kotlin">
+المنصة المطلوبة: '''JVM'''.<syntaxhighlight lang="kotlin">
 inline fun Char.isIdentifierIgnorable(): Boolean
-</syntaxhighlight>يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]].
+</syntaxhighlight>وجود الكلمة المفتاحية <code>inline</code> يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، ارجع إلى صفحة [[Kotlin/inline functions|الدوال المباشرة (inline functions)]]).
 == القيم المعادة ==
-قيمة منطقية.
+تعاد القيمة <code>true</code> إن كان [[Kotlin/Char|المحرف]] المعطى محرفًا قابلًا للإهمال (ignorable character) في مُعرِّفات جافا (Java identifier) أو معرِّفات الترميز الموحَّد (Unicode identifier)، أو تعاد القيمة <code>false</code> خلاف ذلك.
 == أمثلة ==
+استعمال الدالة <code>isIdentifierIgnorable()‎</code> لمعرفة أي المحرفين التاليين هو محرف قابل للإهمال في محرفات جافا أو معرفات الترميز الموحد:<syntaxhighlight lang="kotlin">
-=== استخدام الدالة <code>isIdentifierIgnorable()‎</code> مع الحروف ===
-تُعرّف الشيفرة الآتية [[Kotlin/Char/index|حرفين]] <code>x</code> و <code>y</code> ثم تستدعي الدالة <code>isIdentifierIgnorable()‎</code> عبرهما، ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
 fun main(args: Array<String>) {
      val x = 'a'
-     val y = '\u0000'
+     val y = '\u0000' // null character
 	print(x.isIdentifierIgnorable()) // false
@@ سطر 22: / سطر 20: @@
 </syntaxhighlight>
 == انظر أيضًا ==
-* <code>[[Kotlin/text/isHighSurrogate|isHighSurrogate()]]‎</code>: تعيد القيمة <code>true</code> في حال كان الحرف الذي استٌدعيت عبره بديلًا علويًا لكود اليونيكود (Unicode high-surrogate code unit).
+*الدالة [[Kotlin/text/equals|<code>equals()</code>‎]]: تتحقق من تساوي محرفين أو سلسلتين نصيتين مع بعضهما بعضًا.
-* <code>[[Kotlin/text/isDefined|isDefined()]]‎</code>: تعيد القيمة <code>true</code> في حال كان الحرف (Unicode code point) الذي استٌدعيت عبره مُعرّفًا في اليونيكود (Unicode).
+*الدالة [[Kotlin/text/isDefined|<code>isDefined()</code>‎]]: تتحقق إن كان [[Kotlin/Char|المحرف]] (Unicode code point) الذي استٌدعيت معها مُعرّفًا في الترميز الموحَّد (Unicode) أم لا.
+*الدالة [[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/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-identifier-ignorable.html صفحة الدالة isIdentifierIgnorable()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
 [[تصنيف:Kotlin Method]]